From 0ab9979693c5bba70b58ed0a45dbdff6bd301c88 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Thorsten=20Ro=C3=9Fner?= <thorsten.rossner.extern@zendis.de>
Date: Wed, 19 Nov 2025 16:30:26 +0100
Subject: [PATCH] docs(gettings-started.md): Update section "Access deployment"

---
 docs/getting-started.md | 40 +++++++++++++++++++++++++---------------
 1 file changed, 25 insertions(+), 15 deletions(-)

diff --git a/docs/getting-started.md b/docs/getting-started.md
index ac2fc220..3250a96e 100644
--- a/docs/getting-started.md
+++ b/docs/getting-started.md
@@ -32,8 +32,10 @@ This documentation lets you create an openDesk evaluation instance on your Kuber
   * [Install](#install)
   * [Install single app](#install-single-app)
   * [Install single release/chart](#install-single-releasechart)
-* [Access deployment](#access-deployment)
   * [Using from external repository](#using-from-external-repository)
+* [Access deployment](#access-deployment)
+  * [Login](#login)
+  * [Credentials](#credentials)
 * [Uninstall](#uninstall)
 <!-- TOC -->
 
@@ -448,17 +450,37 @@ Instead of iterating through all services, you can also deploy a single release
 helmfile apply -e dev -n <NAMESPACE> -l name=mariadb
 ```
 
+## Using from external repository
+
+Referring to `./helmfile_generic.yaml.gotmpl` from an external
+directory or repository is possible. The `helmfile.yaml.gotmpl` that refers to
+`./helmfile_generic.yaml.gotmpl` may define custom environments. These custom
+environments may overwrite specific configuration values. These
+configuration values are:
+
+* `global.domain`
+* `global.helmRegistry`
+* `global.master_password`
+
 # Access deployment
 
+## Login
+
 When all apps are successfully deployed, and their Pod status is `Running` or `Succeeded`, you can navigate to
 
+```text
+https://domain.tld
+```
+
+which will redirect you to the actual URL of the openDesk portal:
+
 ```text
 https://portal.domain.tld
 ```
 
-If you change the subdomain of `nubus`, you must replace the subdomain of `portal` with the same subdomain.
+By default the portal will send you to openDesk's login screen.
 
-**Credentials:**
+## Credentials
 
 openDesk deploys with the standard user account `Administrator`, the password for which can be retrieved as follows:
 
@@ -490,18 +512,6 @@ docker run --rm registry.opencode.de/bmi/opendesk/components/platform-developmen
     --create_admin_accounts True
 ```
 
-## Using from external repository
-
-Referring to `./helmfile_generic.yaml.gotmpl` from an external
-directory or repository is possible. The `helmfile.yaml.gotmpl` that refers to
-`./helmfile_generic.yaml.gotmpl` may define custom environments. These custom
-environments may overwrite specific configuration values. These
-configuration values are:
-
-* `global.domain`
-* `global.helmRegistry`
-* `global.master_password`
-
 # Uninstall
 
 You can uninstall the deployment by executing the following: