rcstack: use dl server

README.md

@@ -1,393 +1,393 b''
 # RhodeCode Cluster
 
 RhodeCode Cluster is a multi-node highly-scalable setup to run 
 RhodeCode, Edge Router(Traefik + SSL) and Metrics Stack (Prometheus, Loki, Grafana) and
 all its additional components in single environment using Docker.
 
 Using a docker-compose this setup creates following services for RhodeCode:
 
 Edge-Router:
 
  - Traefik, Edge Router, SSL termination etc
 
 Core Services:
 
  - Database (defaults to PostgreSQL)
  - Redis, acts as cache and queue exchange
  - ChannelStream - live websocket communications
  - Nginx (static/channelstream) proxy serving RhodeCode static files and channelstream communication
  - Elasticsearch (full text search backend)
 
 RhodeCode
 
  - RhodeCode CE/EE
  - VCSServer for GIT/SVN/HG support
  - SSH Server for cloning over SSH
  - SVN webserver for HTTP support over SVN
  - Celery workers for asynchronous tasks
  - Celery beat for automation tasks
 
 Metrics
 
  - Loki, logs aggregation
  - Grafana, metrics Dashboard
  - Prometheus, metrics time-series
  - Statsd-exporter - statsd to Prometheus bridge
  - Node-exporter - machine stats and usage
  - Promtail - log scraping
 
 ##rcstack for Linux, new docker based installer
 
  To get started with RhodeCode get the new shell installer called rcstack
 
 ```
 mkdir docker-rhodecode && cd docker-rhodecode
-curl -s -o rcstack https://code.rhodecode.com/rhodecode-enterprise-docker/raw/master/scripts/rcstack/rcstack && chmod +x rcstack
+curl -L -s -o rcstack https://dls.rhodecode.com/get/master && chmod +x rcstack
 ./rcstack get-started
 ```
 
 ## Pre requisites
 
 To Run this stack Docker engine and Docker Compose needs to be installed on the host machine.
 Please run `./rcstack init` to install docker using the installer, or 
 visit docker site and install docker (min version 20.10) and docker compose:
 
 - https://docs.docker.com/engine/install/
 - https://docs.docker.com/compose/install/ 
 
 ./rcstack init can install docker on linux machine, but if manual installation is 
 required it's also possible by simply installing docker before
 
 
 
 # Quick install tutorial
 
 Those are step-by-step installation/run steps.
 
  create configurations / docker definitions:
     
     ./rcstack init
 
  At this point a custom file under .custom/.runtime.env was created. Adjust it if required.
 
  Start Traefik router that would handle all incoming traffic, load balance. A valid domain needs to be present in 
  .custom/.runtime.env to access the RhodeCOde
     
     ./rcstack stack router up --detach
  
  Start the database and bootstrap it
 
     ./rcontrol stack database up --detach
  
  Start other services required
 
     ./rcstack stack services up --detach
 
  Start RhodeCode stack
     
     ./rcstack stack rhodecode up --detach
 
  Check stack status
 
     ./rcstack status
 
  Output should look similar like this:
 
     ---
     CONTAINER ID   IMAGE                                   STATUS                        NAMES                                 PORTS
     ef54fc528e3a   traefik:v2.9.5                          Up 2 hours             rc_cluster_router-traefik-1           0.0.0.0:80->80/tcp, :::80->80/tcp
     f3ea0539e8b0   rhodecode/rhodecode-ee:4.28.0           Up 2 hours (healthy)   rc_cluster_apps-rhodecode-1           0.0.0.0:10020->10020/tcp, :::10020->10020/tcp
     2be52ba58ffe   rhodecode/rhodecode-ee:4.28.0           Up 2 hours (healthy)   rc_cluster_apps-vcsserver-1
     7cd730ad3263   rhodecode/rhodecode-ee:4.28.0           Up 2 hours (healthy)   rc_cluster_apps-celery-1
     dfa231342c87   rhodecode/rhodecode-ee:4.28.0           Up 2 hours (healthy)   rc_cluster_apps-celery-beat-1
     d3d76ce2de96   rhodecode/rhodecode-ee:4.28.0           Up 2 hours (healthy)   rc_cluster_apps-sshd-1
     daaac329414b   rhodecode/rhodecode-ee:4.28.0           Up 2 hours (healthy)   rc_cluster_apps-svn-1
     7b8504fb9acb   nginx:1.23.2                            Up 2 hours (healthy)   rc_cluster_services-nginx-1           80/tcp
     7279c25feb6b   elasticsearch:6.8.23                    Up 2 hours (healthy)   rc_cluster_services-elasticsearch-1   9200/tcp, 9300/tcp
     19fb93587493   redis:7.0.5                             Up 2 hours (healthy)   rc_cluster_services-redis-1           6379/tcp
     fb77fb6496c6   channelstream/channelstream:0.7.1       Up 2 hours (healthy)   rc_cluster_services-channelstream-1   8000/tcp
     cb6c5c022f5b   postgres:14.6                           Up 2 hours (healthy)   rc_cluster_services-database-1        5432/tcp
 
 # Standalone cluster build from installer
 
 If you;d like to build your own custom image here's a quick how to.:
 Follow these steps to build and run the RhodeCode Cluster via Docker-compose.
 
 1) Run:
 
     ./rcstack init
 
 2) Run artifacts fetch like installer and certain needed build binaries:
 
    Start by fetching required installer binaries. This is required to create both
    simple build and full compose setup.
    Please use the `--version-name VERSION_NAME` flag to adjust RhodeCode version if needed.
    (e.g. --version-name "4.24.1")
    
    ```
    ./rcstack get-build-artifacts
    ```
    
     This will download required installer files and put them into the `.cache` directory. 
     This directory should look similar to that after downloads have finish:
     
     ```
     drwxr-xr-x   8 rcdev  rcdev   256B Feb  8 13:35 .
     drwxr-xr-x  14 rcdev  rcdev   448B Feb  8 10:40 ..
     -rw-r--r--   1 rcdev  rcdev     0B Feb  8 20:44 .dirkeep
     -rwxr-xr-x   1 rcdev  rcdev   241M Feb  8 13:35 RhodeCode-installer-linux-build20210208_0800
     -rw-r--r--   1 rcdev  rcdev   156M Feb  8 13:35 RhodeCodeCommunity-4.24.1+x86_64-linux_build20210208_0800.tar.bz2
     -rw-r--r--   1 rcdev  rcdev   171M Feb  8 13:35 RhodeCodeEnterprise-4.24.1+x86_64-linux_build20210208_0800.tar.bz2
     -rw-r--r--   1 rcdev  rcdev   145M Feb  8 13:35 RhodeCodeVCSServer-4.24.1+x86_64-linux_build20210208_0800.tar.bz2
     -rw-r--r--   1 rcdev  rcdev   109M Feb  8 13:35 locale-archive
     ```
 
 
 3) Create the build
 
     ./rcstack build-installer
 
 # Standalone cluster build from source code
 
 There's an option to build the latest release from the source code as a docker installation.
 If you;d like to build your own custom image based on the source code here's a quick how to.:
 Follow these steps to build and run the RhodeCode Cluster via Docker-compose.
 
 1) Run init to setup needed docker env and files:
 
     ./rcstack init
 
 2) Run artifacts fetch like installer and certain needed build binaries:
 
    Start by fetching required installer binaries.
    Only local-archive is required to be present, installer is disregarded for source build
    
    ```
    ./rcstack get-build-artifacts
    ```
    
     This will download required installer files and put them into the `.cache` directory. 
     This directory should look similar to that after downloads have finish:
     
     ```
     drwxr-xr-x   8 rcdev  rcdev   256B Feb  8 13:35 .
     drwxr-xr-x  14 rcdev  rcdev   448B Feb  8 10:40 ..
     -rw-r--r--   1 rcdev  rcdev     0B Feb  8 20:44 .dirkeep
     -rwxr-xr-x   1 rcdev  rcdev   241M Feb  8 13:35 RhodeCode-installer-linux-build20210208_0800
     -rw-r--r--   1 rcdev  rcdev   156M Feb  8 13:35 RhodeCodeCommunity-4.24.1+x86_64-linux_build20210208_0800.tar.bz2
     -rw-r--r--   1 rcdev  rcdev   171M Feb  8 13:35 RhodeCodeEnterprise-4.24.1+x86_64-linux_build20210208_0800.tar.bz2
     -rw-r--r--   1 rcdev  rcdev   145M Feb  8 13:35 RhodeCodeVCSServer-4.24.1+x86_64-linux_build20210208_0800.tar.bz2
     -rw-r--r--   1 rcdev  rcdev   109M Feb  8 13:35 locale-archive
     ```
 
 3) get source code needed to create a build
 
     This step will create source code copies into the `.source/` path. So it will look like this:
     
    ```
     -rw-r--r-- 1 docker docker    0 Nov 25 12:27 .dirkeep
     drwxr-xr-x 1 docker docker 1184 Nov 25 12:27 rhodecode-enterprise-ce
     drwxr-xr-x 1 docker docker 1120 Nov 25 12:27 rhodecode-enterprise-ee
     drwxr-xr-x 1 docker docker  800 Nov 25 12:27 rhodecode-vcsserver
     ```
 
     If you have the 3 required projects source code already, this step can be omitted, and the 
     sources can be copied to the `.source/` directory. note: symlinks don't work.
 
     - https://code.rhodecode.com/rhodecode-vcsserver
     - https://code.rhodecode.com/rhodecode-enterprise-ce
     - https://code.rhodecode.com/rhodecode-enterprise-ee (assuming access is granted to this)
 
     Run this to fetch the sources
 
     ```
     ./rcstack get-build-source --revision=default --auth-token=xxxx --server-url=https://code.rhodecode.com/sources
     ```
 
 
 4) Create the build
    
     ```
     ./rcstack build-source --version-name 4.28.0.REL.2022.12.12
     ```
 
 # Operation
 
 ## Data structure
 
 There are 4 volumes defined:
 
 
 - `/etc/rhodecode/conf`
   
   Shared volume used for configuration files for rhodecode, vcsserver and supervisord, and some cache data
 
 - `/var/opt/rhodecode_repo_store` 
 
   Used for main repository storage where repositories would be stored
   
 - `/var/opt/rhodecode_data` 
   
   Data dir for rhodecode cache/lock files, or user sessions (for file backend)
 
 
 ## Set License for EE version
 
 In order to install EE edition a license file is required to be present.
 It can contain your current license, or when empty license can be applied via Web interface.
 
 To apply it during build phase save your raw license data into a file 
 
 `config/rhodecode_enterprise.license` 
 
 If this file is present build phase will read it and license will be applied at creation.
 This file can also be empty and license can be applied via a WEB interface after first login.
 
 ## Run Docker compose build:
 
 *This will build RhodeCode based on downloaded installer packages.*
 
 To create a full stack we need to run the database container, so it's ready to
 build the docker image.
 
 _Disk space problems?_
      
 ```
 docker system df
 docker builder prune -f
 # optionally
 docker image prune -a
 ```
 
 ### Creating & building images
 
 1) start with running the required database for the build stage in the background.
    
     ```
     docker-compose up --detach database
     ```
    
     This will start our postgres database, and expose it to the network.
     Postgres DB is configured to output logs into a stdout
 
 2) We can now run the full installation. Database needs to be running for the next build command.
    This will build the rhodecode base image used for rhodecode, vcsserver, celery, ssh, svn
    Then it will build all other components required.
 
     ```
     docker-compose build rhodecode
     docker-compose build
     ```
 
 4) Once we build all required containers, we can run the whole stack using `docker-compose up`
 
     ```
     docker-compose up
     ```
 
 If running locally you can access Running RhodeCode via Nginx under:
 http://localhost:8888
 
 localhost can be changed to the server IP where docker is running.
 
 
 In case for bigger setups docker-compose can scale more rhodecode/vcsserver workers:
 
 ```
 docker-compose up --scale vcsserver=3 rhodecode=3
 ```
 
 Logging is pushed to stdout from all services.
 
 
 ### Upgrade procedure:
 
 - run ./rcstack self-update
 - run ./rcstack stack-upgrade to get upgrade instructions
 
 
 With this done, you can now proceed with every step of normal source installation (Creating & building images), but instead of using
 just `docker-compose` command it needs to be replaced with `docker-compose -f docker-compose.yaml -f docker-compose.source.yaml`
 
 For example to override the installer build with the source `rhodecode` based image, and also setting proper version, run:
 
 ```
 RC_VERSION="4.28.0.SRC.2022.12.12.1" docker-compose -f docker-compose-apps.yaml -f docker-compose.source.yaml build --no-cache --progress=plain rhodecode
 ```
 
 NOTE THAT it's recommended to keep rc_version and source_Ver the same
 
 ## Simple community build
 
 Build docker RhodeCode `Community` without any dependencies (redis, external db) using 
 simple sqlite database and file based caches. 
 This is a fully running instance good for small use with 3-5 users.
 
 ```
 docker build -t rhodecode/rhodecode-ce:4.23.2 -f rhodecode.dockerfile \
 -e RHODECODE_TYPE=Community \
 -e RHODECODE_VERSION=4.23.2 \
 -e RHODECODE_DB=sqlite \
 -e RHODECODE_USER_NAME=admin \
 -e RHODECODE_USER_PASS=secret4 \
 -e RHODECODE_USER_EMAIL=[e-mail] \
 .
 ```
 
 note: for debugging better to add `--progress plain` into the build command to obtain all the output from the build.
 To Build against existing running Postgres or MySQL you can specify:
 
     --build-arg RHODECODE_DB=postgresql://postgres:secret@database/rhodecode
     --build-arg RHODECODE_DB=mysql://root:secret@localhost/rhodecode?charset=utf8
 
 
 To copy over the data into volumes use such command:
 ```
 docker run -v logvolume:/data --name data_vol busybox true
 docker cp . data_vol:/data
 docker rm data_vol
 ```
 
 Run the container, mounting the required volumes. By default the application would be
 available at http://localhost:10020, and default login is (unless specified differently in the build command)
 
 ```
 user: admin
 password: secret4
 ```
 
 We've not built our image using specific version. It's time to run it:
 We specify the run.ini by selecting config option we have locally
 
 ```
 docker run \
   --name rhodecode-container \
   --publish 10020:10020 \
   --restart unless-stopped \
   --volume $PWD/config:/etc/rhodecode/conf \
   --volume $PWD/config/rhodecode.ini:/etc/rhodecode/conf_build/rhodecode.ini \
   'rhodecode/rhodecode-ee:4.23.2'
 ```
 
 Enter container
 
 ```
 docker exec -it rhodecode-container /bin/bash
 ```
 
 Enter interactive shell
 
 ```
 docker exec -it rhodecode-container /usr/local/bin/rhodecode_bin/bin/rc-ishell /etc/rhodecode/conf/rhodecode.ini
 ```
 
 Run Database migrations
 ```
 docker exec -it rhodecode-container /usr/local/bin/rhodecode_bin/bin/rc-upgrade-db /etc/rhodecode/conf/rhodecode.ini --force-yes
 ```
 
 
 
 ### Registry for docker swarm
 
 docker run -d -p 5000:5000 --restart always --name registry registry:2
  No newline at end of file

scripts/rcstack/rcstack

@@ -1,5699 +1,5710 b''
 #!/usr/bin/env bash
 # This script was generated
 # Modifying it manually is not recommended
 
 check_bash_version() {
    if [ ! "${BASH_VERSINFO:-0}" -ge 4 ]; then
       echo "Bash version 4 or greater is required (got ${BASH_VERSINFO}), please update your bash version!"
       exit 1
    fi
 }
 check_bash_version
 
 # :command.master_script
 
 # :command.version_command
 version_command() {
   echo "$version"
 }
 
 # :command.usage
 rcstack_usage() {
   if [[ -n $long_usage ]]; then
     printf "rcstack - CLI for installing and managing RhodeCode Cluster Stack\n"
     echo
 
   else
     printf "rcstack - CLI for installing and managing RhodeCode Cluster Stack\n"
     echo
 
   fi
 
   printf "%s\n" "Usage:"
   printf "  rcstack [OPTIONS] COMMAND\n"
   printf "  rcstack [COMMAND] --help | -h\n"
   printf "  rcstack --version | -v\n"
   echo
   # :command.usage_commands
   printf "%s\n" "Commands:"
   printf "  %s   Print instructions to get started with rhodecode docker stack\n" "get-started        "
   printf "  %s   Bootstrap this machine, check docker version and install rhodecode-network\n" "init               "
   printf "  %s   Update rcstack and it's docker definitions\n" "self-update        "
   echo
   printf "%s\n" "Stack Commands:"
   printf "  %s   Run one of available cluster stacks, run stack -h for more details\n" "stack              "
   printf "  %s   Show stack status\n" "stack-status       "
   printf "  %s   Upgrade a stack, run stack-upgrade -h for more details\n" "stack-upgrade      "
   echo
   printf "%s\n" "CLI Commands:"
   printf "  %s   Various CLI tools, run cli -h for more details\n" "cli                "
   echo
   printf "%s\n" "Backup Commands:"
   printf "  %s   Backup Database\n" "backup-db          "
   printf "  %s   Backup RhodeCode storage\n" "backup-data        "
   echo
   printf "%s\n" "Build Commands:"
   printf "  %s   Fetch Artifacts to run installer based build\n" "get-build-artifacts"
   printf "  %s   Build RhodeCode image from installer, ./rcstack get-build-artifacts initially\n" "build-installer    "
   printf "  %s   Fetch RhodeCode sources, store in .source dir to run a source-based builds\n" "get-build-source   "
   printf "  %s   Build RhodeCode image from source, requires ./rcstack get-build-source initially\n" "build-source       "
   echo
 
   # :command.long_usage
   if [[ -n $long_usage ]]; then
     printf "%s\n" "Options:"
 
     # :command.usage_fixed_flags
     printf "  %s\n" "--help, -h"
     printf "    Show this help\n"
     echo
     printf "  %s\n" "--version, -v"
     printf "    Show version number\n"
     echo
 
     # :command.usage_flags
     # :flag.usage
     printf "  %s\n" "--debug"
     printf "    Enable debug and detailed output\n"
     echo
 
     # :flag.usage
     printf "  %s\n" "--no-init-check"
     printf "    Skip check for ./rcstack init call\n"
     echo
 
     # :command.usage_environment_variables
     printf "%s\n" "Environment Variables:"
 
     # :environment_variable.usage
     printf "  %s\n" "RCC_CONFIG"
     printf "    default config file for rcstack\n"
     printf "    Default: .rcstack.ini\n"
     echo
 
     # :environment_variable.usage
     printf "  %s\n" "AUTH_TOKEN"
     printf "    Set your RhodeCode AUTH Token\n"
     echo
 
     # :environment_variable.usage
     printf "  %s\n" "RC_STACK_ROUTER_EXT"
     printf "\n"
     printf "    Default: .custom/docker-compose-router.override.yaml\n"
     echo
 
     # :environment_variable.usage
     printf "  %s\n" "RC_STACK_METRICS_EXT"
     printf "\n"
     printf "    Default: .custom/docker-compose-metrics.override.yaml\n"
     echo
 
     # :environment_variable.usage
     printf "  %s\n" "RC_STACK_SERVICES_EXT"
     printf "\n"
     printf "    Default: .custom/docker-compose-services.override.yaml\n"
     echo
 
     # :environment_variable.usage
     printf "  %s\n" "RC_STACK_RHODECODE_EXT"
     printf "\n"
     printf "    Default: .custom/docker-compose-apps.override.yaml\n"
     echo
 
     # :command.footer
     printf "RhodeCode Inc 2023\n\n"
     echo
 
   fi
 }
 
 # :command.usage
 rcstack_get_started_usage() {
   if [[ -n $long_usage ]]; then
     printf "rcstack get-started - Print instructions to get started with rhodecode docker stack\n"
     echo
 
   else
     printf "rcstack get-started - Print instructions to get started with rhodecode docker stack\n"
     echo
 
   fi
 
   printf "%s\n" "Usage:"
   printf "  rcstack get-started\n"
   printf "  rcstack get-started --help | -h\n"
   echo
 
   # :command.long_usage
   if [[ -n $long_usage ]]; then
     printf "%s\n" "Options:"
 
     # :command.usage_fixed_flags
     printf "  %s\n" "--help, -h"
     printf "    Show this help\n"
     echo
 
   fi
 }
 
 # :command.usage
 rcstack_init_usage() {
   if [[ -n $long_usage ]]; then
     printf "rcstack init - Bootstrap this machine, check docker version and install rhodecode-network\n"
     echo
 
   else
     printf "rcstack init - Bootstrap this machine, check docker version and install rhodecode-network\n"
     echo
 
   fi
 
   printf "%s\n" "Usage:"
   printf "  rcstack init [OPTIONS]\n"
   printf "  rcstack init --help | -h\n"
   echo
 
   # :command.long_usage
   if [[ -n $long_usage ]]; then
     printf "%s\n" "Options:"
 
     # :command.usage_fixed_flags
     printf "  %s\n" "--help, -h"
     printf "    Show this help\n"
     echo
 
     # :command.usage_flags
     # :flag.usage
     printf "  %s\n" "--force, -f"
     printf "    Overwrite existing files\n"
     echo
 
     # :flag.usage
     printf "  %s\n" "--auth-token AUTH_TOKEN"
     printf "    Optionally specify AUTH TOKEN to obtain sources\n"
     echo
 
     # :flag.usage
     printf "  %s\n" "--server-url SERVER_URL"
     printf "    Specify RhodeCode server location where projects should be downloaded\n"
     printf "    Default: https://code.rhodecode.com\n"
     echo
 
     # :flag.usage
     printf "  %s\n" "--revision REVISION"
     printf "    revision to fetch new definitions.\n"
     printf "    Default: master\n"
     echo
 
     # :flag.usage
     printf "  %s\n" "--install-docker INSTALL_DOCKER"
     printf "    answer [y]es or [n]o to question to install docker\n"
     echo
 
     # :command.usage_examples
     printf "%s\n" "Examples:"
     printf "  - ./rcstack init\n  - ./rcstack init --force\n  # non-interactive mode to say yes to install docker question [n] always does\n  not install docker\n  - ./rcstack init --install-docker=y\n"
     echo
 
   fi
 }
 
 # :command.usage
 rcstack_self_update_usage() {
   if [[ -n $long_usage ]]; then
     printf "rcstack self-update - Update rcstack and it's docker definitions\n"
     echo
 
   else
     printf "rcstack self-update - Update rcstack and it's docker definitions\n"
     echo
 
   fi
 
   printf "%s\n" "Usage:"
   printf "  rcstack self-update [OPTIONS]\n"
   printf "  rcstack self-update --help | -h\n"
   echo
 
   # :command.long_usage
   if [[ -n $long_usage ]]; then
     printf "%s\n" "Options:"
 
     # :command.usage_fixed_flags
     printf "  %s\n" "--help, -h"
     printf "    Show this help\n"
     echo
 
     # :command.usage_flags
     # :flag.usage
     printf "  %s\n" "--installer-revision INSTALLER_REVISION"
     printf "    revision to fetch new installer.\n"
     printf "    Default: master\n"
     echo
 
     # :flag.usage
     printf "  %s\n" "--revision REVISION"
     printf "    revision to fetch new docker definitions.\n"
     printf "    Default: master\n"
     echo
 
     # :flag.usage
     printf "  %s\n" "--auth-token AUTH_TOKEN"
     printf "    Optionally specify AUTH TOKEN to obtain sources\n"
     echo
 
     # :flag.usage
     printf "  %s\n" "--server-url SERVER_URL"
     printf "    Specify RhodeCode server location where projects should be downloaded\n"
     printf "    Default: https://code.rhodecode.com\n"
     echo
 
     # :command.usage_examples
     printf "%s\n" "Examples:"
-    printf "  - ./rccstack self-update simply to update it to a new version\n  - ./rccstack self-update --installer-revision=dev --revision=dev to fetch dev\n  branch and install it\n  # In case rcstack breaks, you can always just fetch the stack script using\n  curl\n  curl -s -o rcstack\n  https://code.rhodecode.com/rhodecode-enterprise-docker/raw/master/scripts/rcstack/rcstack\n  && chmod +x rcstack\n"
+    printf "  - ./rccstack self-update simply to update it to a new version\n  \n  # to fetch dev branch and install it\n  - ./rccstack self-update --installer-revision=dev --revision=dev\n  \n  # In case rcstack breaks, you can re-download the stack script using curl\n  curl -L -s -o rcstack https://dls.rhodecode.com/get/master && chmod +x rcstack\n"
     echo
 
   fi
 }
 
 # :command.usage
 rcstack_stack_usage() {
   if [[ -n $long_usage ]]; then
     printf "rcstack stack - Run one of available cluster stacks, run stack -h for more details\n"
     echo
 
   else
     printf "rcstack stack - Run one of available cluster stacks, run stack -h for more details\n"
     echo
 
   fi
 
   printf "%s\n" "Usage:"
   printf "  rcstack stack [OPTIONS] COMMAND\n"
   printf "  rcstack stack [COMMAND] --help | -h\n"
   echo
   # :command.usage_commands
   printf "%s\n" "Commands:"
   printf "  %s   run the router stack\n" "router   "
   printf "  %s   run the router stack\n" "metrics  "
   printf "  %s   run the router stack\n" "services "
   printf "  %s   run the router stack\n" "rhodecode"
   printf "  %s   run all stacks\n" "all      "
   echo
 
   # :command.long_usage
   if [[ -n $long_usage ]]; then
     printf "%s\n" "Options:"
 
     # :command.usage_fixed_flags
     printf "  %s\n" "--help, -h"
     printf "    Show this help\n"
     echo
 
     # :command.usage_flags
     # :flag.usage
     printf "  %s\n" "--env-file-path ENV_FILE_PATH"
     printf "    Set custom env file\n"
     printf "    Default: $PWD/.custom/.runtime.env\n"
     echo
 
     # :command.usage_examples
     printf "%s\n" "Examples:"
     printf "  # running stack\n  - ./rcstack stack router up          # run router stack with output to stdout\n  - ./rcstack stack router up --detach # run router stack detached\n  - ./rcstack stack router down        # stop whole router stack\n  - ./rcstack stack router ps          # check status of router stack\n  \n  # logs, use logs -f to follow/tail --until 1h to limit for last time\n  - ./rcstack stack services logs -f database\n  \n  # scale a single stack service[s] to more replicas (horizontally), use\n  overrides files to permanently set scale\n  - ./rcstack stack rhodecode up --detach --no-recreate --scale rhodecode=2\n  --scale vcsserver=2\n  \n  # run router stack with your overrides compose file\n  - ./rcstack stack router -f docker-overrides.yaml up -d\n"
     echo
 
   fi
 }
 
 # :command.usage
 rcstack_stack_router_usage() {
   if [[ -n $long_usage ]]; then
     printf "rcstack stack router - run the router stack\n"
     echo
 
   else
     printf "rcstack stack router - run the router stack\n"
     echo
 
   fi
 
   printf "%s\n" "Usage:"
   printf "  rcstack stack router [SERVICES PARAMS...]\n"
   printf "  rcstack stack router --help | -h\n"
   echo
 
   # :command.long_usage
   if [[ -n $long_usage ]]; then
     printf "%s\n" "Options:"
 
     # :command.usage_fixed_flags
     printf "  %s\n" "--help, -h"
     printf "    Show this help\n"
     echo
 
     # :command.usage_args
     printf "%s\n" "Arguments:"
 
     echo "  SERVICES PARAMS..."
     printf "    Additional arguments or flags for services command\n"
     echo
 
   fi
 }
 
 # :command.usage
 rcstack_stack_metrics_usage() {
   if [[ -n $long_usage ]]; then
     printf "rcstack stack metrics - run the router stack\n"
     echo
 
   else
     printf "rcstack stack metrics - run the router stack\n"
     echo
 
   fi
 
   printf "%s\n" "Usage:"
   printf "  rcstack stack metrics [SERVICES PARAMS...]\n"
   printf "  rcstack stack metrics --help | -h\n"
   echo
 
   # :command.long_usage
   if [[ -n $long_usage ]]; then
     printf "%s\n" "Options:"
 
     # :command.usage_fixed_flags
     printf "  %s\n" "--help, -h"
     printf "    Show this help\n"
     echo
 
     # :command.usage_args
     printf "%s\n" "Arguments:"
 
     echo "  SERVICES PARAMS..."
     printf "    Additional arguments or flags for services command\n"
     echo
 
   fi
 }
 
 # :command.usage
 rcstack_stack_services_usage() {
   if [[ -n $long_usage ]]; then
     printf "rcstack stack services - run the router stack\n"
     echo
 
   else
     printf "rcstack stack services - run the router stack\n"
     echo
 
   fi
 
   printf "%s\n" "Usage:"
   printf "  rcstack stack services [SERVICES PARAMS...]\n"
   printf "  rcstack stack services --help | -h\n"
   echo
 
   # :command.long_usage
   if [[ -n $long_usage ]]; then
     printf "%s\n" "Options:"
 
     # :command.usage_fixed_flags
     printf "  %s\n" "--help, -h"
     printf "    Show this help\n"
     echo
 
     # :command.usage_args
     printf "%s\n" "Arguments:"
 
     echo "  SERVICES PARAMS..."
     printf "    Additional arguments or flags for services command\n"
     echo
 
   fi
 }
 
 # :command.usage
 rcstack_stack_rhodecode_usage() {
   if [[ -n $long_usage ]]; then
     printf "rcstack stack rhodecode - run the router stack\n"
     echo
 
   else
     printf "rcstack stack rhodecode - run the router stack\n"
     echo
 
   fi
 
   printf "%s\n" "Usage:"
   printf "  rcstack stack rhodecode [SERVICES PARAMS...]\n"
   printf "  rcstack stack rhodecode --help | -h\n"
   echo
 
   # :command.long_usage
   if [[ -n $long_usage ]]; then
     printf "%s\n" "Options:"
 
     # :command.usage_fixed_flags
     printf "  %s\n" "--help, -h"
     printf "    Show this help\n"
     echo
 
     # :command.usage_args
     printf "%s\n" "Arguments:"
 
     echo "  SERVICES PARAMS..."
     printf "    Additional arguments or flags for services command\n"
     echo
 
   fi
 }
 
 # :command.usage
 rcstack_stack_all_usage() {
   if [[ -n $long_usage ]]; then
     printf "rcstack stack all - run all stacks\n"
     echo
 
   else
     printf "rcstack stack all - run all stacks\n"
     echo
 
   fi
 
   printf "%s\n" "Usage:"
   printf "  rcstack stack all [SERVICES PARAMS...]\n"
   printf "  rcstack stack all --help | -h\n"
   echo
 
   # :command.long_usage
   if [[ -n $long_usage ]]; then
     printf "%s\n" "Options:"
 
     # :command.usage_fixed_flags
     printf "  %s\n" "--help, -h"
     printf "    Show this help\n"
     echo
 
     # :command.usage_args
     printf "%s\n" "Arguments:"
 
     echo "  SERVICES PARAMS..."
     printf "    Additional arguments or flags for services command\n"
     echo
 
   fi
 }
 
 # :command.usage
 rcstack_stack_status_usage() {
   if [[ -n $long_usage ]]; then
     printf "rcstack stack-status - Show stack status\n"
     echo
 
   else
     printf "rcstack stack-status - Show stack status\n"
     echo
 
   fi
 
   printf "Alias: status\n"
   echo
 
   printf "%s\n" "Usage:"
   printf "  rcstack stack-status [OPTIONS]\n"
   printf "  rcstack stack-status --help | -h\n"
   echo
 
   # :command.long_usage
   if [[ -n $long_usage ]]; then
     printf "%s\n" "Options:"
 
     # :command.usage_fixed_flags
     printf "  %s\n" "--help, -h"
     printf "    Show this help\n"
     echo
 
     # :command.usage_flags
     # :flag.usage
     printf "  %s\n" "--detailed"
     printf "    Display a detailed format\n"
     echo
 
   fi
 }
 
 # :command.usage
 rcstack_stack_upgrade_usage() {
   if [[ -n $long_usage ]]; then
     printf "rcstack stack-upgrade - Upgrade a stack, run stack-upgrade -h for more details\n"
     echo
 
   else
     printf "rcstack stack-upgrade - Upgrade a stack, run stack-upgrade -h for more details\n"
     echo
 
   fi
 
   printf "%s\n" "Usage:"
   printf "  rcstack stack-upgrade COMMAND\n"
   printf "  rcstack stack-upgrade [COMMAND] --help | -h\n"
   echo
   # :command.usage_commands
   printf "%s\n" "Commands:"
   printf "  %s   upgrade the router stack\n" "router   "
   printf "  %s   run the router stack\n" "metrics  "
   printf "  %s   run the router stack\n" "services "
   printf "  %s   run the router stack\n" "rhodecode"
   echo
 
   # :command.long_usage
   if [[ -n $long_usage ]]; then
     printf "%s\n" "Options:"
 
     # :command.usage_fixed_flags
     printf "  %s\n" "--help, -h"
     printf "    Show this help\n"
     echo
 
     # :command.usage_examples
     printf "%s\n" "Examples:"
     printf "  # Upgrading stack\n  - ./rcstack stack-upgrade router\n  \n  # RhodeCode stack upgrades with 0 downtime using container rotation\n  - ./rcstack stack-upgrade rhodecode\n"
     echo
 
   fi
 }
 
 # :command.usage
 rcstack_stack_upgrade_router_usage() {
   if [[ -n $long_usage ]]; then
     printf "rcstack stack-upgrade router - upgrade the router stack\n"
     echo
 
   else
     printf "rcstack stack-upgrade router - upgrade the router stack\n"
     echo
 
   fi
 
   printf "%s\n" "Usage:"
   printf "  rcstack stack-upgrade router\n"
   printf "  rcstack stack-upgrade router --help | -h\n"
   echo
 
   # :command.long_usage
   if [[ -n $long_usage ]]; then
     printf "%s\n" "Options:"
 
     # :command.usage_fixed_flags
     printf "  %s\n" "--help, -h"
     printf "    Show this help\n"
     echo
 
   fi
 }
 
 # :command.usage
 rcstack_stack_upgrade_metrics_usage() {
   if [[ -n $long_usage ]]; then
     printf "rcstack stack-upgrade metrics - run the router stack\n"
     echo
 
   else
     printf "rcstack stack-upgrade metrics - run the router stack\n"
     echo
 
   fi
 
   printf "%s\n" "Usage:"
   printf "  rcstack stack-upgrade metrics\n"
   printf "  rcstack stack-upgrade metrics --help | -h\n"
   echo
 
   # :command.long_usage
   if [[ -n $long_usage ]]; then
     printf "%s\n" "Options:"
 
     # :command.usage_fixed_flags
     printf "  %s\n" "--help, -h"
     printf "    Show this help\n"
     echo
 
   fi
 }
 
 # :command.usage
 rcstack_stack_upgrade_services_usage() {
   if [[ -n $long_usage ]]; then
     printf "rcstack stack-upgrade services - run the router stack\n"
     echo
 
   else
     printf "rcstack stack-upgrade services - run the router stack\n"
     echo
 
   fi
 
   printf "%s\n" "Usage:"
   printf "  rcstack stack-upgrade services\n"
   printf "  rcstack stack-upgrade services --help | -h\n"
   echo
 
   # :command.long_usage
   if [[ -n $long_usage ]]; then
     printf "%s\n" "Options:"
 
     # :command.usage_fixed_flags
     printf "  %s\n" "--help, -h"
     printf "    Show this help\n"
     echo
 
   fi
 }
 
 # :command.usage
 rcstack_stack_upgrade_rhodecode_usage() {
   if [[ -n $long_usage ]]; then
     printf "rcstack stack-upgrade rhodecode - run the router stack\n"
     echo
 
   else
     printf "rcstack stack-upgrade rhodecode - run the router stack\n"
     echo
 
   fi
 
   printf "%s\n" "Usage:"
   printf "  rcstack stack-upgrade rhodecode [OPTIONS]\n"
   printf "  rcstack stack-upgrade rhodecode --help | -h\n"
   echo
 
   # :command.long_usage
   if [[ -n $long_usage ]]; then
     printf "%s\n" "Options:"
 
     # :command.usage_fixed_flags
     printf "  %s\n" "--help, -h"
     printf "    Show this help\n"
     echo
 
     # :command.usage_flags
     # :flag.usage
     printf "  %s\n" "--restart-unhealthy"
     printf "    just restart unhealthy containers\n"
     echo
 
     # :flag.usage
     printf "  %s\n" "--stop-wait STOP_WAIT"
     printf "    Number of seconds to wait for stopping old containers, use low value to\n    quickly restart and recycle containers\n"
     printf "    Default: 120\n"
     echo
 
   fi
 }
 
 # :command.usage
 rcstack_cli_usage() {
   if [[ -n $long_usage ]]; then
     printf "rcstack cli - Various CLI tools, run cli -h for more details\n"
     echo
 
   else
     printf "rcstack cli - Various CLI tools, run cli -h for more details\n"
     echo
 
   fi
 
   printf "%s\n" "Usage:"
   printf "  rcstack cli COMMAND\n"
   printf "  rcstack cli [COMMAND] --help | -h\n"
   echo
   # :command.usage_commands
   printf "%s\n" "Commands:"
   printf "  %s   print out stored docker image version\n" "image-info         "
   printf "  %s   CLI for Redis\n" "redis              "
   printf "  %s   CLI with Database connection\n" "db                 "
   printf "  %s   CLI to run db upgrade\n" "db-upgrade         "
   printf "  %s   CLI for repository storage. Exposes a basic image with mounted data and repositories volumes\n" "storage            "
   printf "  %s   attach to running instance of RhodeCode, by default it attaches to rhodecode main web app\n" "attach             "
   printf "  %s   reconfigure the vcsserver.ini file\n" "configure-vcsserver"
   printf "  %s   reconfigure the rhodecode.ini file\n" "configure-rhodecode"
   echo
 
   # :command.long_usage
   if [[ -n $long_usage ]]; then
     printf "%s\n" "Options:"
 
     # :command.usage_fixed_flags
     printf "  %s\n" "--help, -h"
     printf "    Show this help\n"
     echo
 
   fi
 }
 
 # :command.usage
 rcstack_cli_image_info_usage() {
   if [[ -n $long_usage ]]; then
     printf "rcstack cli image-info - print out stored docker image version\n"
     echo
 
   else
     printf "rcstack cli image-info - print out stored docker image version\n"
     echo
 
   fi
 
   printf "%s\n" "Usage:"
   printf "  rcstack cli image-info [OPTIONS]\n"
   printf "  rcstack cli image-info --help | -h\n"
   echo
 
   # :command.long_usage
   if [[ -n $long_usage ]]; then
     printf "%s\n" "Options:"
 
     # :command.usage_fixed_flags
     printf "  %s\n" "--help, -h"
     printf "    Show this help\n"
     echo
 
     # :command.usage_flags
     # :flag.usage
     printf "  %s\n" "--set-runtime SET_RUNTIME"
     printf "    set version into .runtime.env\n"
     echo
 
   fi
 }
 
 # :command.usage
 rcstack_cli_redis_usage() {
   if [[ -n $long_usage ]]; then
     printf "rcstack cli redis - CLI for Redis\n"
     echo
 
   else
     printf "rcstack cli redis - CLI for Redis\n"
     echo
 
   fi
 
   printf "%s\n" "Usage:"
   printf "  rcstack cli redis\n"
   printf "  rcstack cli redis --help | -h\n"
   echo
 
   # :command.long_usage
   if [[ -n $long_usage ]]; then
     printf "%s\n" "Options:"
 
     # :command.usage_fixed_flags
     printf "  %s\n" "--help, -h"
     printf "    Show this help\n"
     echo
 
   fi
 }
 
 # :command.usage
 rcstack_cli_db_usage() {
   if [[ -n $long_usage ]]; then
     printf "rcstack cli db - CLI with Database connection\n"
     echo
 
   else
     printf "rcstack cli db - CLI with Database connection\n"
     echo
 
   fi
 
   printf "%s\n" "Usage:"
   printf "  rcstack cli db\n"
   printf "  rcstack cli db --help | -h\n"
   echo
 
   # :command.long_usage
   if [[ -n $long_usage ]]; then
     printf "%s\n" "Options:"
 
     # :command.usage_fixed_flags
     printf "  %s\n" "--help, -h"
     printf "    Show this help\n"
     echo
 
     # :command.usage_examples
     printf "%s\n" "Examples:"
     printf "  # restore backup\n  - \i /var/rc-data-dump/your_dump.sql\n"
     echo
 
   fi
 }
 
 # :command.usage
 rcstack_cli_db_upgrade_usage() {
   if [[ -n $long_usage ]]; then
     printf "rcstack cli db-upgrade - CLI to run db upgrade\n"
     echo
 
   else
     printf "rcstack cli db-upgrade - CLI to run db upgrade\n"
     echo
 
   fi
 
   printf "%s\n" "Usage:"
   printf "  rcstack cli db-upgrade\n"
   printf "  rcstack cli db-upgrade --help | -h\n"
   echo
 
   # :command.long_usage
   if [[ -n $long_usage ]]; then
     printf "%s\n" "Options:"
 
     # :command.usage_fixed_flags
     printf "  %s\n" "--help, -h"
     printf "    Show this help\n"
     echo
 
   fi
 }
 
 # :command.usage
 rcstack_cli_storage_usage() {
   if [[ -n $long_usage ]]; then
     printf "rcstack cli storage - CLI for repository storage. Exposes a basic image with mounted data and repositories volumes\n"
     echo
 
   else
     printf "rcstack cli storage - CLI for repository storage. Exposes a basic image with mounted data and repositories volumes\n"
     echo
 
   fi
 
   printf "%s\n" "Usage:"
   printf "  rcstack cli storage\n"
   printf "  rcstack cli storage --help | -h\n"
   echo
 
   # :command.long_usage
   if [[ -n $long_usage ]]; then
     printf "%s\n" "Options:"
 
     # :command.usage_fixed_flags
     printf "  %s\n" "--help, -h"
     printf "    Show this help\n"
     echo
 
   fi
 }
 
 # :command.usage
 rcstack_cli_attach_usage() {
   if [[ -n $long_usage ]]; then
     printf "rcstack cli attach - attach to running instance of RhodeCode, by default it attaches to rhodecode main web app\n"
     echo
 
   else
     printf "rcstack cli attach - attach to running instance of RhodeCode, by default it attaches to rhodecode main web app\n"
     echo
 
   fi
 
   printf "%s\n" "Usage:"
   printf "  rcstack cli attach [OPTIONS]\n"
   printf "  rcstack cli attach --help | -h\n"
   echo
 
   # :command.long_usage
   if [[ -n $long_usage ]]; then
     printf "%s\n" "Options:"
 
     # :command.usage_fixed_flags
     printf "  %s\n" "--help, -h"
     printf "    Show this help\n"
     echo
 
     # :command.usage_flags
     # :flag.usage
     printf "  %s\n" "--instance-type INSTANCE_TYPE"
     printf "    type of instance to attach to\n"
     printf "    Default: rhodecode\n"
     echo
 
     # :command.usage_examples
     printf "%s\n" "Examples:"
     printf "  ./rcstack cli attach --instance-type sshd\n  ./rcstack cli attach --instance-type vcsserver\n  ./rcstack cli attach --instance-type celery\n  ./rcstack cli attach --instance-type celery-beat\n"
     echo
 
   fi
 }
 
 # :command.usage
 rcstack_cli_configure_vcsserver_usage() {
   if [[ -n $long_usage ]]; then
     printf "rcstack cli configure-vcsserver - reconfigure the vcsserver.ini file\n"
     echo
 
   else
     printf "rcstack cli configure-vcsserver - reconfigure the vcsserver.ini file\n"
     echo
 
   fi
 
   printf "%s\n" "Usage:"
   printf "  rcstack cli configure-vcsserver INI_PATH\n"
   printf "  rcstack cli configure-vcsserver --help | -h\n"
   echo
 
   # :command.long_usage
   if [[ -n $long_usage ]]; then
     printf "%s\n" "Options:"
 
     # :command.usage_fixed_flags
     printf "  %s\n" "--help, -h"
     printf "    Show this help\n"
     echo
 
     # :command.usage_args
     printf "%s\n" "Arguments:"
 
     # :argument.usage
     printf "  %s\n" "INI_PATH"
     printf "    Path to vcsserver.ini to reconfigure\n"
     echo
 
     # :command.usage_examples
     printf "%s\n" "Examples:"
     printf "  ./rcstack cli configure-vcs config/_shared/vcsserver.ini\n"
     echo
 
   fi
 }
 
 # :command.usage
 rcstack_cli_configure_rhodecode_usage() {
   if [[ -n $long_usage ]]; then
     printf "rcstack cli configure-rhodecode - reconfigure the rhodecode.ini file\n"
     echo
 
   else
     printf "rcstack cli configure-rhodecode - reconfigure the rhodecode.ini file\n"
     echo
 
   fi
 
   printf "%s\n" "Usage:"
   printf "  rcstack cli configure-rhodecode INI_PATH\n"
   printf "  rcstack cli configure-rhodecode --help | -h\n"
   echo
 
   # :command.long_usage
   if [[ -n $long_usage ]]; then
     printf "%s\n" "Options:"
 
     # :command.usage_fixed_flags
     printf "  %s\n" "--help, -h"
     printf "    Show this help\n"
     echo
 
     # :command.usage_args
     printf "%s\n" "Arguments:"
 
     # :argument.usage
     printf "  %s\n" "INI_PATH"
     printf "    Path to rhodecode.ini to reconfigure\n"
     echo
 
     # :command.usage_examples
     printf "%s\n" "Examples:"
     printf "  ./rcstack cli configure-rhodecode config/_shared/rhodecode.ini\n"
     echo
 
   fi
 }
 
 # :command.usage
 rcstack_backup_db_usage() {
   if [[ -n $long_usage ]]; then
     printf "rcstack backup-db - Backup Database\n"
     echo
 
   else
     printf "rcstack backup-db - Backup Database\n"
     echo
 
   fi
 
   printf "%s\n" "Usage:"
   printf "  rcstack backup-db\n"
   printf "  rcstack backup-db --help | -h\n"
   echo
 
   # :command.long_usage
   if [[ -n $long_usage ]]; then
     printf "%s\n" "Options:"
 
     # :command.usage_fixed_flags
     printf "  %s\n" "--help, -h"
     printf "    Show this help\n"
     echo
 
     # :command.usage_examples
     printf "%s\n" "Examples:"
     printf "  # make backup gz compressed from container DB\n  - ./rcstack backup-db\n  \n  # restore backup\n  - gunzip your_dump.sql.gz\n  - ./rcstack cli db\n  - \i /var/rc-data-dump/your_dump.sql\n"
     echo
 
   fi
 }
 
 # :command.usage
 rcstack_backup_data_usage() {
   if [[ -n $long_usage ]]; then
     printf "rcstack backup-data - Backup RhodeCode storage\n"
     echo
 
   else
     printf "rcstack backup-data - Backup RhodeCode storage\n"
     echo
 
   fi
 
   printf "%s\n" "Usage:"
   printf "  rcstack backup-data\n"
   printf "  rcstack backup-data --help | -h\n"
   echo
 
   # :command.long_usage
   if [[ -n $long_usage ]]; then
     printf "%s\n" "Options:"
 
     # :command.usage_fixed_flags
     printf "  %s\n" "--help, -h"
     printf "    Show this help\n"
     echo
 
     # :command.usage_examples
     printf "%s\n" "Examples:"
     printf "  # make backup gz compressed for rhodecode containers, and all volumes\n  - ./rcstack backup-data\n"
     echo
 
   fi
 }
 
 # :command.usage
 rcstack_get_build_artifacts_usage() {
   if [[ -n $long_usage ]]; then
     printf "rcstack get-build-artifacts - Fetch Artifacts to run installer based build\n"
     echo
 
   else
     printf "rcstack get-build-artifacts - Fetch Artifacts to run installer based build\n"
     echo
 
   fi
 
   printf "%s\n" "Usage:"
   printf "  rcstack get-build-artifacts [OPTIONS]\n"
   printf "  rcstack get-build-artifacts --help | -h\n"
   echo
 
   # :command.long_usage
   if [[ -n $long_usage ]]; then
     printf "%s\n" "Options:"
 
     # :command.usage_fixed_flags
     printf "  %s\n" "--help, -h"
     printf "    Show this help\n"
     echo
 
     # :command.usage_flags
     # :flag.usage
     printf "  %s\n" "--auth AUTH"
     printf "    Specify custom auth for curl e.g -u admin:secret\n"
     printf "    Default: \n"
     echo
 
     # :flag.usage
     printf "  %s\n" "--installer-url INSTALLER_URL"
     printf "    Installer Download URL\n"
     printf "    Default: https://dls.rhodecode.com/dls/N2E2ZTY1NzA3NjYxNDA2NTc1NjI3MTcyNzA2MjcxNzIyZTcwNjI3YQ==/rhodecode-control/latest-linux-ee\n"
     echo
 
     # :flag.usage
     printf "  %s\n" "--manifest-url MANIFEST_URL"
     printf "    Manifest file url\n"
     printf "    Default: https://dls.rhodecode.com/linux/MANIFEST\n"
     echo
 
     # :flag.usage
     printf "  %s\n" "--version-name VERSION_NAME"
     printf "    Specify custom build ver e.g 4.27.0\n"
     printf "    Default: $RC_CLI_VERSION_NAME\n"
     echo
 
   fi
 }
 
 # :command.usage
 rcstack_build_installer_usage() {
   if [[ -n $long_usage ]]; then
     printf "rcstack build-installer - Build RhodeCode image from installer, ./rcstack get-build-artifacts initially\n"
     echo
 
   else
     printf "rcstack build-installer - Build RhodeCode image from installer, ./rcstack get-build-artifacts initially\n"
     echo
 
   fi
 
   printf "%s\n" "Usage:"
   printf "  rcstack build-installer [OPTIONS]\n"
   printf "  rcstack build-installer --help | -h\n"
   echo
 
   # :command.long_usage
   if [[ -n $long_usage ]]; then
     printf "%s\n" "Options:"
 
     # :command.usage_fixed_flags
     printf "  %s\n" "--help, -h"
     printf "    Show this help\n"
     echo
 
     # :command.usage_flags
     # :flag.usage
     printf "  %s\n" "--version-name VERSION_NAME"
     printf "    Specify custom build ver e.g 4.27.0\n"
     printf "    Default: $RC_CLI_VERSION_NAME\n"
     echo
 
   fi
 }
 
 # :command.usage
 rcstack_get_build_source_usage() {
   if [[ -n $long_usage ]]; then
     printf "rcstack get-build-source - Fetch RhodeCode sources, store in .source dir to run a source-based builds\n"
     echo
 
   else
     printf "rcstack get-build-source - Fetch RhodeCode sources, store in .source dir to run a source-based builds\n"
     echo
 
   fi
 
   printf "%s\n" "Usage:"
   printf "  rcstack get-build-source [OPTIONS]\n"
   printf "  rcstack get-build-source --help | -h\n"
   echo
 
   # :command.long_usage
   if [[ -n $long_usage ]]; then
     printf "%s\n" "Options:"
 
     # :command.usage_fixed_flags
     printf "  %s\n" "--help, -h"
     printf "    Show this help\n"
     echo
 
     # :command.usage_flags
     # :flag.usage
     printf "  %s\n" "--revision REVISION"
     printf "    revision to download\n"
     printf "    Default: default\n"
     echo
 
     # :flag.usage
     printf "  %s\n" "--auth-token AUTH_TOKEN"
     printf "    Specify AUTH TOKEN to obtain sources\n"
     echo
 
     # :flag.usage
     printf "  %s\n" "--server-url SERVER_URL"
     printf "    Specify RhodeCode server location where projects should be downloaded\n"
     printf "    Default: https://code.rhodecode.com\n"
     echo
 
     # :command.usage_examples
     printf "%s\n" "Examples:"
     printf "  ./rcstack get-sources $RC_CLI_VERSION_NAME\n"
     printf "  ./rcstack get-sources default --auth-token xyxyxyx --server-url\n  https://secret.repo/\n"
     echo
 
   fi
 }
 
 # :command.usage
 rcstack_build_source_usage() {
   if [[ -n $long_usage ]]; then
     printf "rcstack build-source - Build RhodeCode image from source, requires ./rcstack get-build-source initially\n"
     echo
 
   else
     printf "rcstack build-source - Build RhodeCode image from source, requires ./rcstack get-build-source initially\n"
     echo
 
   fi
 
   printf "%s\n" "Usage:"
   printf "  rcstack build-source [OPTIONS]\n"
   printf "  rcstack build-source --help | -h\n"
   echo
 
   # :command.long_usage
   if [[ -n $long_usage ]]; then
     printf "%s\n" "Options:"
 
     # :command.usage_fixed_flags
     printf "  %s\n" "--help, -h"
     printf "    Show this help\n"
     echo
 
     # :command.usage_flags
     # :flag.usage
     printf "  %s\n" "--version-name VERSION_NAME"
     printf "    Specify custom build ver e.g 4.27.0\n"
     printf "    Default: $RC_CLI_VERSION_NAME\n"
     echo
 
     # :flag.usage
     printf "  %s\n" "--tag TAG (repeatable)"
     printf "    tag build image\n"
     echo
 
     # :command.usage_examples
     printf "%s\n" "Examples:"
     printf "  ./rcstack build-source --version-name 4.28.0.REL.2023.02.02.1\n"
     echo
 
   fi
 }
 
 # :command.usage
 rcstack__completions_usage() {
   if [[ -n $long_usage ]]; then
     printf "rcstack _completions - Generate completions\n"
     echo
 
   else
     printf "rcstack _completions - Generate completions\n"
     echo
 
   fi
 
   printf "%s\n" "Usage:"
   printf "  rcstack _completions\n"
   printf "  rcstack _completions --help | -h\n"
   echo
 
   # :command.long_usage
   if [[ -n $long_usage ]]; then
     printf "%s\n" "Options:"
 
     # :command.usage_fixed_flags
     printf "  %s\n" "--help, -h"
     printf "    Show this help\n"
     echo
 
   fi
 }
 
 # :command.normalize_input
 normalize_input() {
   local arg flags
 
   while [[ $# -gt 0 ]]; do
     arg="$1"
     if [[ $arg =~ ^(--[a-zA-Z0-9_\-]+)=(.+)$ ]]; then
       input+=("${BASH_REMATCH[1]}")
       input+=("${BASH_REMATCH[2]}")
     elif [[ $arg =~ ^(-[a-zA-Z0-9])=(.+)$ ]]; then
       input+=("${BASH_REMATCH[1]}")
       input+=("${BASH_REMATCH[2]}")
     elif [[ $arg =~ ^-([a-zA-Z0-9][a-zA-Z0-9]+)$ ]]; then
       flags="${BASH_REMATCH[1]}"
       for ((i = 0; i < ${#flags}; i++)); do
         input+=("-${flags:i:1}")
       done
     else
       input+=("$arg")
     fi
 
     shift
   done
 }
 # :command.inspect_args
 inspect_args() {
   readarray -t sorted_keys < <(printf '%s\n' "${!args[@]}" | sort)
   if ((${#args[@]})); then
     echo args:
     for k in "${sorted_keys[@]}"; do echo "- \${args[$k]} = ${args[$k]}"; done
   else
     echo args: none
   fi
 
   if ((${#other_args[@]})); then
     echo
     echo other_args:
     echo "- \${other_args[*]} = ${other_args[*]}"
     for i in "${!other_args[@]}"; do
       echo "- \${other_args[$i]} = ${other_args[$i]}"
     done
   fi
 }
 
 # :command.user_lib
 # src/lib/check_bootstrap.sh
 
 check_bootstrap() {
   # Avoid destroying bootstrapping by simple start/stop
 for stage in $BOOTSTRAP_STAGES; do
 
     stage_name=$(echo $stage | cut -d ":" -f 1)
     stage_func=$(echo $stage | cut -d ":" -f 2)
     if ! config_has_key $stage_name ; then
       echo "$(yellow WARNING:) bootstrap key $stage_name not found in config file $CONFIG_FILE!"
       echo "$(yellow NOTICE:) Please run ./$RC_SCRIPT_NAME init first"
       exit
     fi
 done
 
 }
 
 # src/lib/colors.sh
 print_in_color() {
   local color="$1"
   shift
   if [[ -z ${NO_COLOR+x} ]]; then
     printf "$color%b\e[0m\n" "$*"
   else
     printf "%b\n" "$*"
   fi
 }
 
 red() { print_in_color "\e[31m" "$*"; }
 green() { print_in_color "\e[32m" "$*"; }
 yellow() { print_in_color "\e[33m" "$*"; }
 blue() { print_in_color "\e[34m" "$*"; }
 magenta() { print_in_color "\e[35m" "$*"; }
 cyan() { print_in_color "\e[36m" "$*"; }
 bold() { print_in_color "\e[1m" "$*"; }
 underlined() { print_in_color "\e[4m" "$*"; }
 red_bold() { print_in_color "\e[1;31m" "$*"; }
 green_bold() { print_in_color "\e[1;32m" "$*"; }
 yellow_bold() { print_in_color "\e[1;33m" "$*"; }
 blue_bold() { print_in_color "\e[1;34m" "$*"; }
 magenta_bold() { print_in_color "\e[1;35m" "$*"; }
 cyan_bold() { print_in_color "\e[1;36m" "$*"; }
 red_underlined() { print_in_color "\e[4;31m" "$*"; }
 green_underlined() { print_in_color "\e[4;32m" "$*"; }
 yellow_underlined() { print_in_color "\e[4;33m" "$*"; }
 blue_underlined() { print_in_color "\e[4;34m" "$*"; }
 magenta_underlined() { print_in_color "\e[4;35m" "$*"; }
 cyan_underlined() { print_in_color "\e[4;36m" "$*"; }
 
 # src/lib/config.sh
 config_init() {
   CONFIG_FILE=${CONFIG_FILE:=config.ini}
   [[ -f "$CONFIG_FILE" ]] || touch "$CONFIG_FILE"
 }
 
 config_get() {
   local key=$1
   local regex="^$key *= *(.+)$"
   local value=""
 
   config_init
 
   while IFS= read -r line || [ -n "$line" ]; do
     if [[ $line =~ $regex ]]; then
       value="${BASH_REMATCH[1]}"
       break
     fi
   done <"$CONFIG_FILE"
 
   echo "$value"
 }
 
 config_set() {
   local key=$1
   shift
   local value="$*"
 
   config_init
 
   local regex="^($key) *= *.+$"
   local output=""
   local found_key=""
   local newline
 
   while IFS= read -r line || [ -n "$line" ]; do
     newline=$line
     if [[ $line =~ $regex ]]; then
       found_key="${BASH_REMATCH[1]}"
       newline="$key = $value"
       output="$output$newline\n"
     elif [[ $line ]]; then
       output="$output$line\n"
     fi
   done <"$CONFIG_FILE"
 
   if [[ -z $found_key ]]; then
     output="$output$key = $value\n"
   fi
 
   printf "%b\n" "$output" >"$CONFIG_FILE"
 }
 
 config_del() {
   local key=$1
 
   local regex="^($key) *="
   local output=""
 
   config_init
 
   while IFS= read -r line || [ -n "$line" ]; do
     if [[ $line ]] && [[ ! $line =~ $regex ]]; then
       output="$output$line\n"
     fi
   done <"$CONFIG_FILE"
 
   printf "%b\n" "$output" >"$CONFIG_FILE"
 }
 
 config_show() {
   config_init
   cat "$CONFIG_FILE"
 }
 
 config_keys() {
   local regex="^([a-zA-Z0-9_\-\/\.]+) *="
 
   config_init
 
   local keys=()
   local key
 
   while IFS= read -r line || [ -n "$line" ]; do
     if [[ $line =~ $regex ]]; then
       key="${BASH_REMATCH[1]}"
       keys+=("$key")
     fi
   done <"$CONFIG_FILE"
   echo "${keys[@]}"
 }
 
 config_has_key() {
   [[ $(config_get "$1") ]]
 }
 
 # src/lib/dotenv.sh
 
 __dotenv=
 __dotenv_file=
 __dotenv_cmd=.env
 
 .env() {
 	REPLY=()
 	[[ $__dotenv_file || ${1-} == -* ]] || .env.--file .env || return
 	if declare -F -- ".env.${1-}" >/dev/null; then .env."$@"; return ; fi
 	.env --help >&2; return 64
 }
 
 .env.-f() { .env.--file "$@"; }
 
 .env.get() {
 	.env::arg "get requires a key" "$@" &&
 	[[ "$__dotenv" =~ ^(.*(^|$'\n'))([ ]*)"$1="(.*)$ ]] &&
 	REPLY=${BASH_REMATCH[4]%%$'\n'*} && REPLY=${REPLY%"${REPLY##*[![:space:]]}"}
 }
 
 .env.parse() {
 	local line key
 	while IFS= read -r line; do
 		line=${line#"${line%%[![:space:]]*}"}  # trim leading whitespace
 		line=${line%"${line##*[![:space:]]}"}  # trim trailing whitespace
 		if [[ ! "$line" || "$line" == '#'* ]]; then continue ; fi
 		if (($#)); then
 			for key; do
 				if [[ $key == "${line%%=*}" ]]; then REPLY+=("$line"); break;
 				fi
 			done
 		else
 			REPLY+=("$line")
 		fi
 	done <<<"$__dotenv"
 	((${#REPLY[@]}))
 }
 
 .env.export() {	! .env.parse "$@" || export "${REPLY[@]}"; }
 
 .env.set() {
 	.env::file load || return ; local key saved=$__dotenv
 	while (($#)); do
 		key=${1#+}; key=${key%%=*}
 		if .env.get "$key"; then
 			REPLY=()
 			if [[ $1 == +* ]]; then shift; continue  # skip if already found
 			elif [[ $1 == *=* ]]; then
 				__dotenv=${BASH_REMATCH[1]}${BASH_REMATCH[3]}$1$'\n'${BASH_REMATCH[4]#*$'\n'}
 			else
 				__dotenv=${BASH_REMATCH[1]}${BASH_REMATCH[4]#*$'\n'}
 				continue   # delete all occurrences
 			fi
 		elif [[ $1 == *=* ]]; then
 			__dotenv+="${1#+}"$'\n'
 		fi
 		shift
 	done
 	[[ $__dotenv == "$saved" ]] || .env::file save
 }
 
 .env.puts() { echo "${1-}">>"$__dotenv_file" && __dotenv+="$1"$'\n'; }
 
 .env.generate() {
 	.env::arg "key required for generate" "$@" || return
 	.env.get "$1" && return || REPLY=$("${@:2}") || return
 	.env::one "generate: ouptut of '${*:2}' has more than one line" "$REPLY" || return
 	.env.puts "$1=$REPLY"
 }
 
 .env.--file() {
 	.env::arg "filename required for --file" "$@" || return
 	__dotenv_file=$1; .env::file load || return
 	(($#<2)) || .env "${@:2}"
 }
 
 .env::arg() { [[ "${2-}" ]] || { echo "$__dotenv_cmd: $1" >&2; return 64; }; }
 
 .env::one() { [[ "$2" != *$'\n'* ]] || .env::arg "$1"; }
 
 .env::file() {
 	local REPLY=$__dotenv_file
 	case "$1" in
 	load)
 		__dotenv=; ! [[ -f "$REPLY" ]] || __dotenv="$(<"$REPLY")"$'\n' || return ;;
 	save)
 		if [[ -L "$REPLY" ]] && declare -F -- realpath.resolved >/dev/null; then
 			realpath.resolved "$REPLY"
 		fi
 		{ [[ ! -f "$REPLY" ]] || cp -p "$REPLY" "$REPLY.bak"; } &&
 		printf %s "$__dotenv" >"$REPLY.bak" && mv "$REPLY.bak" "$REPLY"
 	esac
 }
 #
 #__dotenv() {
 #	set -eu
 #	__dotenv_cmd=${0##*/}
 #	.env.export() { .env.parse "$@" || return 0; printf 'export %q\n' "${REPLY[@]}"; REPLY=(); }
 #	.env "$@" || return $?
 #	${REPLY[@]+printf '%s\n' "${REPLY[@]}"}
 #}
 #if [[ $0 == "${BASH_SOURCE-}" ]]; then __dotenv "$@"; exit; fi
 
 # src/lib/get_docker_definitions.sh
 
 get_docker_definitions() {
   SOURCE_DIR=$PWD
   RHODECODE_DOCKER_HASH=$1
   DEBUG=$2
 
   # download sources
   echo "bootstrap_definitions: download rhodecode docker definitions from $SERVER_URL"
   echo ""
 
   if [ $DEBUG ]; then
     echo "bootstrap_definitions: downloading: $SERVER_URL/rhodecode-enterprise-docker/archive/$RHODECODE_DOCKER_HASH.tgz?with_hash=0"
     curl --header "X-Rc-Auth-Token: $AUTH_TOKEN" -L $SERVER_URL/rhodecode-enterprise-docker/archive/$RHODECODE_DOCKER_HASH.tgz?with_hash=0 | tar -xz -C $SOURCE_DIR
 
     echo "bootstrap_definitions: running CP $SOURCE_DIR/*rhodecode-enterprise-docker-plain/* $SOURCE_DIR"
     cp -v -r -f --update --backup=numbered $SOURCE_DIR/*rhodecode-enterprise-docker-plain/* $SOURCE_DIR
 
     echo "bootstrap_definitions: removing $SOURCE_DIR/*rhodecode-enterprise-docker-plain"
     rm -r $SOURCE_DIR/*rhodecode-enterprise-docker-plain
   else
     curl -s --header "X-Rc-Auth-Token: $AUTH_TOKEN" -L $SERVER_URL/rhodecode-enterprise-docker/archive/$RHODECODE_DOCKER_HASH.tgz?with_hash=0 | tar -xz -C $SOURCE_DIR
     cp -r -f --update --backup=numbered $SOURCE_DIR/*rhodecode-enterprise-docker-plain/* $SOURCE_DIR
     rm -r $SOURCE_DIR/*rhodecode-enterprise-docker-plain
   fi
 
   echo "$(green bootstrap_definitions: docker definitions extracted to $SOURCE_DIR)"
 
   # cleanup
-  find -nowarn -ignore_readdir_race $SOURCE_DIR -name "*.~*~" -delete
+  find -nowarn -ignore_readdir_race "$SOURCE_DIR" -name "*.~*~" -delete
 }
 
 # src/lib/reconfigure_ini.sh
 config_vcsserver_ini() {
 
     #host/port
     sed_replace '^#?host = .*'               'host = 0\.0\.0\.0'
     sed_replace '^#?port = .*'               'port = 10010'
 
     # workers adjustment
     sed_replace '^#?workers = .*'            'workers = 1'
     sed_replace '^#?memory_max_usage = .*'   'memory_max_usage = 2147483648'
     sed_replace '^#?core\.binary_dir = .*'   'core.binary_dir = \/home\/rhodecode\/\.rccontrol\/vcsserver-1\/profile\/bin'
 
     sed_replace '^#?rc_cache\.repo_object\.expiration_time = .*'                          'rc_cache.repo_object.expiration_time = 2592000'
     sed_replace '^#?rc_cache\.repo_object\.backend = dogpile\.cache\.rc\.redis_msgpack'   'rc_cache.repo_object.backend = dogpile.cache.rc.redis_msgpack'
 
     sed_replace '^#?rc_cache\.repo_object\.arguments\.socket_timeout = .*'                'rc_cache.repo_object.arguments.socket_timeout = 30'
     sed_replace '^#?rc_cache\.repo_object\.arguments\.db = .*'                            'rc_cache.repo_object.arguments.db = 5'
     sed_replace '^#?rc_cache\.repo_object\.arguments\.port = .*'                          'rc_cache.repo_object.arguments.port = 6379'
     sed_replace '^#?rc_cache\.repo_object\.arguments\.host = .*'                          'rc_cache.repo_object.arguments.host = redis'
     sed_replace '^#?rc_cache\.repo_object\.arguments\.redis_expiration_time = .*'         'rc_cache.repo_object.arguments.redis_expiration_time = 3592000'
 
     sed_replace '^#?cache_dir = .*'   'cache_dir = \/var\/opt\/rhodecode_data'
     sed_replace '^#?formatter = .*'   'formatter = json'
 }
 
 config_rhodecode_ini() {
     #host/port
     sed_replace '^#?host = .*'               'host = 0\.0\.0\.0'
     sed_replace '^#?port = .*'               'port = 10020'
 
     # workers adjustment
     sed_replace '^#?workers = .*' 'workers = 1'
     sed_replace '^#?memory_max_usage = .*'   'memory_max_usage = 2147483648'
 
     # email
     sed_replace '^#?email_prefix = .*'   'email_prefix = [RhodeCode]'
     sed_replace '^#?app_email_from = .*' "app_email_from = rhodecode-noreply@$RC_HOSTNAME"
     sed_replace '^#?smtp_server = .*'    'smtp_server = localhost'
 
     # set license_token
     sed_replace '^#?license_token =.*' "license_token = $RC_LICENSE_TOKEN"
 
     # enable celery
     sed_replace '^#?use_celery = .*', 'use_celery = true'
 
     # set cache dir
     sed_replace '^#?cache_dir = .*'   'cache_dir = \/var\/opt\/rhodecode_data'
 
     # cleanup rabbitmq example entry
     sed_replace '^#celery\.broker_url = amqp.*'  ''
     sed_replace '^#?celery\.broker_url = .*'     'celery\.broker_url = redis:\/\/redis:6379\/8'
 
     # switch beaker sessions to Redis based
     sed_replace '^#?beaker.session.type = file.*' '#beaker.session.type = file'
     sed_replace '^#?beaker.session.data_dir = .*'  '#beaker.session.data_dir = \/tmp\/data\/sessions'
 
     # enable redis db2
     sed_replace '^#?beaker\.session\.type = ext:redis'                  'beaker.session.type = ext:redis'
     sed_replace '^#?beaker\.session\.url = redis:\/\/127.0.0.1:6379\/2' 'beaker.session.url = redis:\/\/redis:6379\/2'
 
 #    sed_replace '^#?beaker.session.type = ext:database.*' 'beaker.session.type = ext:database'
 #    sed_replace '^#?beaker.session.sa.url = postgresql.*' 'beaker.session.sa.url = postgresql://{{rhodecode_db_username}}:{{rhodecode_db_password}}@localhost/{{rhodecode_db_name}}'
 
     # hooks reconfigure for auto-bind to host
     sed_replace '^#?vcs.hooks.host = .*' 'vcs.hooks.host = \*'
 
     # enable SVN
     sed_replace '^#?svn.proxy.generate_config = .*' 'svn.proxy.generate_config = true'
 
     # enable SSH
     sed_replace '^#?ssh.generate_authorized_keyfile = .*' 'ssh.generate_authorized_keyfile = true'
 
 #    # the wrapper_cmd
 #    sed_replace '^#?ssh.wrapper_cmd = .*' 'ssh.wrapper_cmd = /home/{{vm_account_name}}/dev-code/rhodecode-enterprise-ee/profile/bin/rc-ssh-wrapper'
 #
 
 #    '^#?api_access_controllers_whitelist = .*', 'api_access_controllers_whitelist = RepoFilesView:repo_archivefile, RepoFilesView:repo_file_raw'
 #
 #
 #    # set search to elasticsearch
 #      # enabled modules for Whoosh we remove, we have duplicates there..
 #    '^search.module = .*', ''
 #    '^search.location = .*', ''
 #
 #    '^#?search.module = .*', 'search.module = rc_elasticsearch'
 #    '^#?search.location = .*', 'search.location = http://localhost:9200'
 #    '^#?search.es_version = .*', 'search.es_version = 6'
 
 #    # enable Chat
 #    '^#?chat.enabled = .*', 'chat.enabled = true'
 
     # logging
     sed_replace '^#?formatter = .*'   'formatter = json'
 
 }
 
 # src/lib/send_completions.sh
 
 # src/lib/utils.sh
 random_str() {
   len=$1
   random_generate=$(echo $RANDOM | md5sum | head -c $len)
   echo $random_generate
 }
 
 # src/lib/validate_stack_exists.sh
 
 validate_stack_exists() {
   err=""
   invalid="1"
 
   for item in $VALID_SERVICES
   do
       if [ "$1" == "$item" ]; then
           invalid=""
           break
       fi
   done
 
   if [[ -n $invalid ]]; then
     err="command '$1' not in list of $VALID_SERVICES"
   fi
 
   echo $err
 }
 
 # :command.command_functions
 # :command.function
 rcstack_get_started_command() {
   # src/get_started_command.sh
   get_started_full
 }
 
 # :command.function
 rcstack_init_command() {
   # src/init_command.sh
   DEBUG=${args[--debug]}
   force=${args[--force]}
   revision=${args[--revision]}
   install_docker=${args[--install-docker]}
 
   check_docker() {
     (which docker || which docker.io) &>/dev/null
   }
 
   bootstrap_docker_install() {
     # systemctl enable docker on debian
     echo "bootstrap_docker_install: trying to check and configure docker"
     failMsg="Failed to find docker on your PATH"
 
     if ! check_docker; then
 
       if [[ $install_docker == "n" ]]; then
         echo "$(red $failMsg, exiting without docker install)"
       fi
 
       echo "$(yellow $failMsg, trying docker install)"
 
       if [[ $install_docker == "y" ]]; then
         echo "continuing with automated docker installation from https://get.docker.com/ "
       else
         read -p "Enter to install Docker directly from https://get.docker.com/ or Ctrl+C to exit and install it manually"
       fi
 
       curl https://get.docker.com/ | sh
 
       if ! check_docker; then
         echo "$failMsg"
         echo "Docker install failed. Quitting."
         exit 1
       fi
 
       docker --version
 
     fi
   }
 
   bootstrap_docker_commons() {
 
     echo 'bootstrap_docker_commons: running docker commands.'
 
     echo "bootstrap_docker_commons: creating volume 'rc_datavolume'"
     docker volume create --label keep=1 --name=rc_datavolume
     echo "bootstrap_docker_commons: done"
     echo ""
 
     echo "bootstrap_docker_commons: creating volume 'rc_reposvolume'"
     docker volume create --label keep=1 --name=rc_reposvolume
     echo "bootstrap_docker_commons: done"
     echo ""
 
     echo "bootstrap_docker_commons: creating network 'rhodecode_network'"
     docker network inspect rhodecode_network >/dev/null 2>&1 || docker network create rhodecode_network
     echo "bootstrap_docker_commons: done"
     echo ""
 
     echo "bootstrap_docker_commons: creating loki logging"
     loki_driver=$(docker plugin ls --format {{.Name}} --filter enabled=true | grep loki || echo "")
     if [[ $loki_driver == "" ]]; then
       docker plugin install grafana/loki-docker-driver:latest --alias loki --grant-all-permissions
     else
       echo "bootstrap_docker_commons: loki driver already exists"
     fi
   }
 
   bootstrap_config() {
     shared_key=$(random_str 32)
     db_key=$(random_str 32)
     license_token="$(random_str 4)"-"$(random_str 4)"-"$(random_str 4)"-"$(random_str 4)"
 
     # TODO: change formatter to json for loki usage
     log_formatter=generic
 
     #TODO: ask for domain
     base_domain=docker-dev
 
     # TODO: config input
     #  while [[ "$config_ok" == "n" ]]
     #  do
     #    if [ ! -z "$hostname" ]
     #    then
     #      read -p "Enter a valid hostname for RhodeCode Stack? [$hostname]: " new_value
     #      if [ ! -z "$new_value" ]
     #      then
     #        hostname="$new_value"
     #      fi
     #      if [[ $hostname =~ ^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$ ]]
     #      then
     #        echo
     #        echo "$(red IP addresses are unsupported and will not work. Please provide a DNS hostname)"
     #        echo
     #        hostname="rc-docker.local"
     #      fi
     #    fi
 
     DB_USER='rhodecode'
     DB_NAME='rhodecode'
 
     if [[ ! -f "$CONFIG_FILE" ]]; then
       echo "init new config at: $CONFIG_FILE"
       config_init
     else
       echo "re-using existing config at: $CONFIG_FILE"
     fi
 
     mkdir -p $PWD/.custom
     BOOTSTRAP_TMPL=$PWD/templates/runtime.env.tmpl
     BOOTSTRAP_RUNTIME_ENV=$PWD/.custom/.runtime.env
 
     # TODO: Pick version
     ver=0_edge
     INI_TARGET=$PWD/config/_shared
     RHODECODE_INI_TMPL=$PWD/templates/ini/$ver/rhodecode.ini
     VCSSERVER_INI_TMPL=$PWD/templates/ini/$ver/vcsserver.ini
 
     if [[ ! -f "$BOOTSTRAP_RUNTIME_ENV" ]]; then
       echo "bootstrap_config: init runtime env config at: $BOOTSTRAP_RUNTIME_ENV"
 
       # Make runtime file
       echo "## BOOTSTRAP GENERATED" >> $BOOTSTRAP_RUNTIME_ENV
       cat $BOOTSTRAP_TMPL >> $BOOTSTRAP_RUNTIME_ENV
 
       # Make .ini files
       cp -v $RHODECODE_INI_TMPL $INI_TARGET
       cp -v $VCSSERVER_INI_TMPL $INI_TARGET
 
       # init env generator with env file
       .env --file $BOOTSTRAP_RUNTIME_ENV
 
       .env set DB_PASSWORD=$db_key
 
       .env set RC_ENCRYPTED_SECRET=$shared_key
       .env set RC_DB_URL="postgresql://$DB_USER:$db_key@database/$DB_NAME"
       .env set RC_SQLALCHEMY_DB1_URL="postgresql://$DB_USER:$db_key@database/$DB_NAME"
 
       .env set RC_LICENSE_TOKEN=$license_token
       .env set RC_HOSTNAME=$base_domain
       .env set RC_APP_BASE_URL=http://$base_domain
 
       .env puts '# Log formatter option'
       .env set RC_LOGGING_FORMATTER=$log_formatter
       .env set RC_USE_CELERY=true
 
       .env puts '# Channelstream config'
       .env set RC_CHANNELSTREAM_SERVER=channelstream:8000
       .env set RC_CHANNELSTREAM_WS_URL=ws:/$base_domain/_channelstream
       .env set CHANNELSTREAM_ALLOW_POSTING_FROM=0.0.0.0
 
       .env set CHANNELSTREAM_SECRET=$shared_key
       .env set RC_CHANNELSTREAM_SECRET=$shared_key
 
       .env set CHANNELSTREAM_ADMIN_SECRET=$shared_key
       .env set RC_CHANNELSTREAM_ADMIN_SECRET=$shared_key
 
       touch $BOOTSTRAP_RUNTIME_ENV
     else
       echo "bootstrap_config: $BOOTSTRAP_RUNTIME_ENV file exists, not adding any configuration..."
     fi
   }
 
   bootstrap_definitions() {
 
     AUTH_TOKEN=${args[--auth-token]}
     SERVER_URL=${args[--server-url]}
 
     DEFINITIONS_EXIST=""
     CHECK_FILES="\
     docker-compose-services.yaml \
     docker-compose-apps.yaml \
     docker-compose-metrics.yaml \
     docker-compose-router.yaml \
     "
     for check_file in $CHECK_FILES; do
       if [[ -f "$check_file" ]]; then
         DEFINITIONS_EXIST="1"
       fi
     done
 
     if [[ -n $DEFINITIONS_EXIST && ! $force ]]; then
         echo "$(yellow bootstrap_definitions: skipping docker defs creation, existing files found. Use --force to create them anyway)"
         return
     fi
 
     if [[ -n $DEFINITIONS_EXIST ]]; then
         echo "$(yellow docker definitions exists, are you sure to force re-create them?)"
         while true; do
           read -p "Would you like to continue with overriding file? [yn] " yn
           case $yn in
             [Yy]*) break ;;
             [Nn]*) exit ;;
             *) echo "Please answer y or n." ;;
           esac
         done
     fi
 
     get_docker_definitions $revision $DEBUG
   }
 
   bootstrap_overrides() {
     templates=$(find $PWD/templates/*.yaml -printf "%f\n")
 
     target_dir=$PWD/.custom
 
     for o_file in $templates; do
       target_file=$target_dir/$o_file
       if [[ ! -f "$target_file" ]]; then
         echo "copy override file $o_file"
         cp -v $PWD/templates/$o_file $target_file
       else
         echo "file $target_file existing, skipping..."
       fi
     done
     mkdir -p $target_dir/traefik_custom
     cp -r $PWD/config/traefik/* $target_dir/traefik_custom/
 
     echo "$(green bootstrap_overrides: overrides extracted to $target_dir)"
   }
 
   cur_date=$(date '+%Y-%m-%d %H:%M:%S')
 
   # Init the config !
   if [[ ! -f "$CONFIG_FILE" ]]; then
     echo "config: init new config at: $CONFIG_FILE"
     config_init
   else
     echo "config: re-using present config at: $CONFIG_FILE"
   fi
 
   for stage in $BOOTSTRAP_STAGES; do
 
       stage_name=$(echo $stage | cut -d ":" -f 1)
       stage_func=$(echo $stage | cut -d ":" -f 2)
 
       if ! config_has_key $stage_name ; then
         echo "$(green \* bootstrap: \'$stage_name\' stage not found\; running now... )"
         $stage_func
         config_set "$stage_name" $cur_date
       else
         if [ $force ]; then
           echo "$(green \* bootstrap: \'$stage_name\' is present!\; FORCE running now... )"
           $stage_func $force
           config_set "$stage_name" $cur_date
         else
           echo "$(yellow \* bootstrap: \'$stage_name\' already present, use --force to run it again)"
         fi
       fi
 
   done
 
   echo "~~~~ $(green Bootstrap completed) ~~~~"
 
   get_started
 
 }
 
 # :command.function
 rcstack_self_update_command() {
   # src/self_update_command.sh
   check_bootstrap
 
   DEBUG=${args[--debug]}
   AUTH_TOKEN=${args[--auth-token]}
   SERVER_URL=${args[--server-url]}
   installer_revision=${args[--installer-revision]}
   revision=${args[--revision]}
 
   FETCH_FROM=$SERVER_URL/rhodecode-enterprise-docker/raw/$installer_revision/scripts/rcstack/rcstack
 
   FINAL_TARGET=$PWD/scripts/rcstack/rcstack
 
   DL_TARGET=$PWD/scripts/rcstack/rcstack.tmp
 
   #ensure we have this dir !
   mkdir -p $PWD/scripts/rcstack
 
   .env --file $RUNTIME_ENV
   .env get RC_VERSION
 
   ENV_VER=$REPLY
 
   echo "$(green self-update: downloading new $RC_SCRIPT_NAME script from $FETCH_FROM)"
   if [[ $DEBUG ]]; then
     echo "running: curl --no-progress-meter --fail --header \"X-Rc-Auth-Token: $AUTH_TOKEN\" -o $DL_TARGET -L $FETCH_FROM"
   fi
 
-  curl --no-progress-meter --fail --header "X-Rc-Auth-Token: $AUTH_TOKEN" -o $DL_TARGET -L $FETCH_FROM
+  curl -L --no-progress-meter --fail --header "X-Rc-Auth-Token: $AUTH_TOKEN" -o $DL_TARGET $FETCH_FROM
 
   chmod +x $DL_TARGET
 
+  version_old=0
+  rc_version_old=0
+
+  # check if we have OLD file, in case we don't just set versions to 0
+  if [[ -f "$FINAL_TARGET" ]]; then
   version_old=$($FINAL_TARGET --version)
   rc_version_old=$($FINAL_TARGET cli image-info)
+  fi
 
   version_dl=$($DL_TARGET --version)
   rc_version_dl=$($DL_TARGET cli image-info)
 
   echo "self-update: $RC_SCRIPT_NAME version downloaded: $version_dl"
 
   if [[ $DEBUG ]]; then
     echo "DEBUG: old-script ver: $version_old"
     echo "DEBUG: new-script ver: $version_dl"
     echo "DEBUG: "
     echo "DEBUG: .runtime.env set version $ENV_VER"
     echo "DEBUG: "
     echo "DEBUG: old-script: RC VERSION: $rc_version_old"
     echo "DEBUG: new-script: RC VERSION: $rc_version_dl"
   fi
 
   if [[ $version_old == "$version_dl" ]]; then
     echo "$(yellow self-update: downloaded version is the same as current version $version_dl, exiting...)"
     exit
   fi
 
   if [[ $rc_version_old == "$rc_version_dl" ]]; then
     echo "$(yellow self-update: already set RC_VERSION=$rc_version_dl seems to be up-to date)"
   else
     echo "$(green self-update: saving new RC_VERSION=$rc_version_dl to runtime.env file)"
 
     echo "currently .runtime.env file uses image: $ENV_VER"
     while true; do
       read -p "self-update: Would you like to continue with setting RC_VERSION=$rc_version_dl into .runtime.env file? [yn] " yn
       case $yn in
         [Yy]*)
           .env set RC_VERSION=$rc_version_dl
           echo "self-update: new version set into config"
           break ;;
         [Nn]*)
           break ;;
         *) echo "Please answer y or n." ;;
       esac
     done
 
   fi
 
   echo "$(green self-update: updating $RC_SCRIPT_NAME script to new version: $version_dl)"
+
+  if [[ -f "$FINAL_TARGET" ]]; then
   rm $FINAL_TARGET && mv -v $DL_TARGET $FINAL_TARGET
+  else
+    mv -v $DL_TARGET $FINAL_TARGET
+  fi
 
   get_docker_definitions $revision $DEBUG
 
   exit
 }
 
 # :command.function
 rcstack_stack_router_command() {
   # src/stack_router_command.sh
   check_bootstrap
 
   DEBUG=${args[--debug]}
   ENV_FILE=${args[--env-file-path]}
 
   if [[ ! -f $RC_STACK_ROUTER_EXT ]]; then
     RC_STACK_ROUTER_EXT=""
   else
     RC_STACK_ROUTER_EXT="-f $RC_STACK_ROUTER_EXT"
   fi
 
   CMD_ROUTER="\
   RC_ENV_FILE=$ENV_FILE docker compose \
   --env-file $ENV_FILE \
   $ENV_EXPAND \
   -p rc_cluster_router \
   -f docker-compose-base.yaml \
   -f docker-compose-router.yaml $RC_STACK_ROUTER_EXT"
 
   if [[ $DEBUG ]]; then
     echo "---"
     echo "stacks docker: $RC_STACK_ROUTER_EXT_LCL"
     echo "running command: ${CMD_ROUTER}"
     echo "ARGS: ${other_args[*]}"
     echo "---"
   fi
   eval "${CMD_ROUTER} ${other_args[*]}"
 
 }
 
 # :command.function
 rcstack_stack_metrics_command() {
   # src/stack_metrics_command.sh
   check_bootstrap
 
   DEBUG=${args[--debug]}
   ENV_FILE=${args[--env-file-path]}
 
   if [[ ! -f $RC_STACK_METRICS_EXT ]]; then
     RC_STACK_METRICS_EXT_LCL=""
   else
     RC_STACK_METRICS_EXT_LCL="-f $RC_STACK_METRICS_EXT"
   fi
 
   CMD_METRICS="\
   RC_ENV_FILE=$ENV_FILE docker compose \
   --env-file $ENV_FILE \
   $ENV_EXPAND \
   -p rc_cluster_metrics \
   -f docker-compose-base.yaml \
   -f docker-compose-metrics.yaml $RC_STACK_METRICS_EXT_LCL"
 
   if [[ $DEBUG ]]; then
     echo "---"
     echo "stacks docker: $RC_STACK_METRICS_EXT_LCL"
     echo "running command: ${CMD_METRICS}"
     echo "ARGS: ${other_args[*]}"
     echo "---"
   fi
   eval "${CMD_METRICS} ${other_args[*]}"
 }
 
 # :command.function
 rcstack_stack_services_command() {
   # src/stack_services_command.sh
   check_bootstrap
 
   DEBUG=${args[--debug]}
   ENV_FILE=${args[--env-file-path]}
 
   if [[ ! -f $RC_STACK_SERVICES_EXT ]]; then
     RC_STACK_SERVICES_EXT_LCL=""
   else
     RC_STACK_SERVICES_EXT_LCL="-f $RC_STACK_SERVICES_EXT"
   fi
 
   RC_STACK_PROFILES="--profile database --profile redis --profile elasticsearch --profile channelstream"
 
   CMD_SERVICES="\
   RC_ENV_FILE=$ENV_FILE docker compose \
   --env-file $ENV_FILE \
   $ENV_EXPAND \
   $RC_STACK_PROFILES \
   -p rc_cluster_services \
   -f docker-compose-base.yaml \
   -f docker-compose-services.yaml $RC_STACK_SERVICES_EXT_LCL"
 
   if [[ $DEBUG ]]; then
     echo "---"
     echo "stacks docker: $RC_STACK_SERVICES_EXT_LCL"
     echo "running command: ${CMD_SERVICES}"
     echo "ARGS: ${other_args[*]}"
     echo "---"
   fi
 
   eval "${CMD_SERVICES} ${other_args[*]}"
 }
 
 # :command.function
 rcstack_stack_rhodecode_command() {
   # src/stack_rhodecode_command.sh
   check_bootstrap
 
   DEBUG=${args[--debug]}
   ENV_FILE=${args[--env-file-path]}
 
   if [[ ! -f $RC_STACK_RHODECODE_EXT ]]; then
     RC_STACK_RHODECODE_EXT_LCL=""
   else
     RC_STACK_RHODECODE_EXT_LCL="-f $RC_STACK_RHODECODE_EXT"
   fi
 
   CMD_RHODECODE="\
   RC_ENV_FILE=$ENV_FILE docker compose \
   --env-file $ENV_FILE \
   $ENV_EXPAND \
   -p rc_cluster_apps \
   -f docker-compose-base.yaml \
   -f docker-compose-apps.yaml $RC_STACK_RHODECODE_EXT_LCL"
 
   CMD_RHODECODE_SOURCE="\
   RC_ENV_FILE=$ENV_FILE docker compose \
   --env-file $ENV_FILE \
   $ENV_EXPAND \
   -p rc_cluster_apps \
   -f docker-compose-base.yaml \
   -f docker-compose-apps.yaml \
   -f docker-compose-apps.source.yaml $RC_STACK_RHODECODE_EXT_LCL"
 
   if [[ $DEBUG ]]; then
     echo "---"
     echo "stacks docker: $RC_STACK_RHODECODE_EXT_LCL"
     echo "running command: ${CMD_RHODECODE}"
     echo "ARGS: ${other_args[*]}"
     echo "---"
   fi
   eval "${CMD_RHODECODE} ${other_args[*]}"
 
 }
 
 # :command.function
 rcstack_stack_all_command() {
   # src/stack_all_command.sh
   check_bootstrap
 
   DEBUG=${args[--debug]}
 
   stack_lst=$VALID_SERVICES
 
   for stack in $stack_lst; do
     ./$RC_SCRIPT_NAME stack $stack ${other_args[*]}
   done
 
 }
 
 # :command.function
 rcstack_stack_status_command() {
   # src/stack_status_command.sh
   check_bootstrap
   DEBUG=${args[--debug]}
   DETAILED=${args[--detailed]}
 
   .env --file $RUNTIME_ENV
   .env get RC_APP_BASE_URL
   RC_APP_BASE_URL=$REPLY
 
   if [[ $DEBUG ]]; then
     echo "---"
       ps_cmd=$(docker ps --filter=name=rc_cluster --format="{{.ID}}")
 
       for service in $ps_cmd; do
 
         servicename=`docker inspect --format '{{ .Name }}' $service`
         servicename=${servicename:1}
         echo $servicename
         docker inspect $service --format='{{.State.Status}}: {{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}'
         echo ""
 
       done
     echo "---"
     fi
 
   echo "Running hostname: $RC_APP_BASE_URL"
   if [[ $DETAILED ]]; then
       ps_cmd=$(docker ps --filter=name=rc_cluster --format="{{.ID}}")
 
       for service in $ps_cmd; do
         servicename=`docker inspect --format '{{ .Name }}' $service`
         servicename=${servicename:1}
         printf "CONTAINER:\\t$servicename\n"
         printf "LOGS:\\t\\tdocker logs --tail=100 $service\n"
         docker ps --filter=name=$servicename --format="ID:\\t\\t{{.ID}}\nIMAGE:\\t\\t{{.Image}}\nSTATUS:\\t\\t{{.Status}}\nPORTS:\\t\\t{{.Ports}}\n"
         echo ""
       done
   else
       docker ps --filter=name=rc_cluster --format "table {{.ID}}\t{{.Names}}\t{{.Image}}\t{{.Status}}\t{{.Ports}}" | (read -r; printf "%s\n" "$REPLY"; sort -k 2 )
   fi
 
 }
 
 # :command.function
 rcstack_stack_upgrade_router_command() {
   # src/stack_upgrade_router_command.sh
   echo "To upgrade this stack run this:"
   echo "./$RC_SCRIPT_NAME stack router up --force-recreate --build --detach"
   echo ""
   echo "NOTE: To reclaim space occupied by old images, run:"
   echo "docker image prune -f"
 
 }
 
 # :command.function
 rcstack_stack_upgrade_metrics_command() {
   # src/stack_upgrade_metrics_command.sh
   echo "To upgrade this stack run this:"
   echo "./$RC_SCRIPT_NAME stack metrics up --force-recreate --build --detach"
   echo ""
   echo "NOTE: To reclaim space occupied by old images, run:"
   echo "docker image prune -f"
 
 }
 
 # :command.function
 rcstack_stack_upgrade_services_command() {
   # src/stack_upgrade_services_command.sh
   echo "To upgrade this stack run this:"
   echo "./$RC_SCRIPT_NAME stack services up --force-recreate --build --detach"
   echo ""
   echo "NOTE: To reclaim space occupied by old images, run:"
   echo "docker image prune -f"
 
 }
 
 # :command.function
 rcstack_stack_upgrade_rhodecode_command() {
   # src/stack_upgrade_rhodecode_command.sh
   check_bootstrap
 
   restart_unhealthy=${args[--restart-unhealthy]}
   stop_wait=${args[--stop-wait]}
   docker_stop_wait=3600
 
   # search docker IDs for current service
   .env --file $RUNTIME_ENV
 
   .env get RC_VERSION
   RC_VERSION=$REPLY
 
   .env get RC_EDITION
   RC_EDITION=$REPLY
 
   if [[ $restart_unhealthy ]]; then
     unhealthy=$(docker ps --filter health=unhealthy --filter label=autoheal=true --format "{{.ID}}")
 
     if [[ $unhealthy == "" ]]; then
       echo "$(green no unhealthy containers found)"
       exit
     fi
 
     echo "$(yellow Found unhealthy containers $unhealthy)"
     for container in $unhealthy
     do
       docker stats --no-stream $container
       echo "unhealthy_log: restart $container"
       docker restart --time=10 $container
     done
 
     exit
   fi
 
   echo "Pulling new image: rhodecode/rhodecode-${RC_EDITION}:${RC_VERSION}"
   echo "WARNING: We are about to start downloading the RhodeCode base image"
   echo "This process may take anywhere between a few minutes to an hour, depending on your network speed"
   echo "running: docker pull -q rhodecode/rhodecode-${RC_EDITION}:${RC_VERSION}"
 
   eval "docker pull -q rhodecode/rhodecode-${RC_EDITION}:${RC_VERSION}"
 
   have_tty=1
   # Set a dummy terminal type if none set
   [[ -z "$TERM" ]] && export have_tty=0
   [[ ! -t 1 ]] && export have_tty=0
 
   set_cursor() {
     if [[ $have_tty == 1 ]]; then
       tput $1
     fi
   }
 
   stop_containers() {
     target_container=$1
     docker_stop_wait=$2
     stop_wait=$3
     target_containers_pat="rc_cluster_apps-$target_container-*"
 
     local docker_ids=$(docker ps --filter name="$target_containers_pat" -q)
     # array with OLD containers
     local old_docker_ids=($docker_ids)
 
     scale=$(echo $docker_ids | wc -w)
     scale_2=$(($scale*2))
 
     echo ""
     echo "Found $scale services for $target_container"
     echo "existing docker-ids:" "${old_docker_ids[@]}"
     echo ""
 
     echo "Scaling to 2x ($scale_2 total) containers for $target_container"
     ./$RC_SCRIPT_NAME stack rhodecode up $target_container --no-recreate --detach --scale $target_container=$scale_2
 
     # array with ALL new containers
     local scaled_docker_ids=($(docker ps --filter name="$target_containers_pat" -q))
 
     # just NEW containers
     local new_docker_ids=($(echo "${old_docker_ids[@]}" "${scaled_docker_ids[@]}" | tr ' ' '\n' | sort | uniq -u))
     local new_docker_ids_str="${new_docker_ids[@]}"
 
   #  echo "${old_docker_ids[@]}"
   #  echo "${scaled_docker_ids[@]}"
   #  echo "${new_docker_ids[@]}"
 
     echo ""
     echo "Scaling completed, running $scale_2 services for upgrade purpose..."
     echo ""
     echo "Stopping $scale old $target_container containers..."
 
     spin='⠾⠽⠻⠟⠯⠷'
     charwidth=1
 
     # wait the required stop-wait time
     #HC: docker inspect --format='{{.Name}}: {{json .ContainerId .State.Health.Status}}' <container-id>
     local i=$(($stop_wait * 10))
     local status=''
 
     # cursor invisible
     set_cursor civis
     while true
       s=$((i / 10))
       do
           i=$(($i-1))
           if [[ $i -lt 1 ]]; then
             break
           fi
 
           if [[ "$(($i % 10))" == 0 ]];
            then
              is_at_sec=1
            else
              is_at_sec=0
           fi
 
           if [[ $is_at_sec == 1 ]]; then
             new_docker_ids_status_cnt=$(docker inspect --format='{{.State.Health.Status}}' $new_docker_ids_str | grep -c "healthy" || echo "")
           fi
 
           if [[ $new_docker_ids_status_cnt -eq $scale ]]; then
             echo "All $target_container are in HEALTHY state; stopping old ones now"
             echo ""
             break
           fi
 
           k=$(((k + $charwidth) % ${#spin}))
 
           if [[ $have_tty == 1 ]]; then
             printf "%s sending stop signal to $scale old containers in $s seconds..." "${spin:$k:$charwidth}"
             printf "\r"
           else
             if [[ $is_at_sec == 1 ]]; then
               echo "sending stop signal to $scale old containers in $s seconds..."
             fi
           fi
 
           sleep .1
       done
       set_cursor cnorm
 
     for container in $docker_ids
     do
       echo "now running container $container stop with --time $docker_stop_wait"
       docker stop --time $docker_stop_wait $container
       docker rm $container
       echo "Stopped $container"
     done
 
   }
 
   # VCSSERVER Containers
   stop_containers "vcsserver" $docker_stop_wait $stop_wait
 
   # RHODECODE Containers
   stop_containers "rhodecode" $docker_stop_wait $stop_wait
 
   # SVN Containers
   stop_containers "svn" $docker_stop_wait $stop_wait
 
   # SSHD Containers
   stop_containers "sshd" $docker_stop_wait $stop_wait
 
   ./$RC_SCRIPT_NAME stack rhodecode up celery --force-recreate --build --detach
   ./$RC_SCRIPT_NAME stack rhodecode up celery-beat --force-recreate --build --detach
 
   echo "Upgrade to rhodecode/rhodecode-${RC_EDITION}:${RC_VERSION} completed"
   exit
 
 }
 
 # :command.function
 rcstack_cli_image_info_command() {
   # src/cli_image_info_command.sh
   set_ver=${args[--set-runtime]}
 
   echo $rc_image_ver
 
   if [ ! -z "$set_ver" ]; then
     echo "setting runtime version to $set_ver into $RUNTIME_ENV"
     .env --file $RUNTIME_ENV
     .env set RC_VERSION=$set_ver
   fi
 
 }
 
 # :command.function
 rcstack_cli_redis_command() {
   # src/cli_redis_command.sh
   check_bootstrap
 
   DEBUG=${args[--debug]}
 
   target_container=rc_cluster_services-redis-1
   docker_id=$(docker ps --filter name=$target_container -q)
 
   if [[ $DEBUG ]]; then
     echo "container id: $docker_id, based on $target_container filter"
     docker ps
   fi
 
   if [ "$docker_id" == "" ]; then
     MSG="Cannot find container ID with name $target_container"
     echo "$(red $MSG)"
     exit 1
   fi
 
   if [[ $DEBUG ]]; then
     echo "Running |docker exec --interactive --tty $docker_id $CMD|"
     echo "docker exec --interactive --tty $docker_id /bin/bash -c 'redis-cli'"
   fi
 
   eval "docker exec --interactive --tty $docker_id /bin/bash -c 'redis-cli'"
 
 }
 
 # :command.function
 rcstack_cli_db_command() {
   # src/cli_db_command.sh
   check_bootstrap
 
   DEBUG=${args[--debug]}
 
   target_container=rc_cluster_services-database-*
   docker_id=$(docker ps --filter name=$target_container -q | head -n1)
 
   if [[ $DEBUG ]]; then
     echo "container id: $docker_id, based on $target_container filter"
     docker ps
   fi
 
   if [ "$docker_id" == "" ]; then
     MSG="Cannot find container ID with name $target_container"
     echo "$(red $MSG)"
     exit 1
   fi
 
   .env --file $RUNTIME_ENV
 
   .env get DB_PASSWORD
   DB_PASSWORD=$REPLY
 
   .env get DB_NAME
   DB_NAME=$REPLY
 
   .env get DB_USER
   DB_USER=$REPLY
 
   if [[ $DEBUG ]]; then
     echo "Running |docker exec --env-file $RUNTIME_ENV --interactive --tty $docker_id $CMD|"
     echo "docker exec --interactive --tty $docker_id  /bin/bash -c 'PGPASSWORD=$DB_PASSWORD psql --username=$DB_USER --dbname=$DB_NAME'"
   fi
 
   echo
   eval "docker exec --env-file $RUNTIME_ENV --interactive --tty $docker_id  /bin/bash -c 'PGPASSWORD=$DB_PASSWORD psql --username=$DB_USER --dbname=$DB_NAME'"
 
 }
 
 # :command.function
 rcstack_cli_db_upgrade_command() {
   # src/cli_db_upgrade_command.sh
   check_bootstrap
 
   DEBUG=${args[--debug]}
 
   target_container=rc_cluster_services-database-*
   docker_id=$(docker ps --filter name=$target_container -q | head -n1)
 
   if [[ $DEBUG ]]; then
     echo "container id: $docker_id, based on $target_container filter"
     docker ps
   fi
 
   if [ "$docker_id" == "" ]; then
     MSG="Cannot find container ID with name $target_container"
     echo "$(red $MSG)"
     exit 1
   fi
 
   if [[ $DEBUG ]]; then
     echo "./$RC_SCRIPT_NAME stack rhodecode exec rhodecode /usr/local/bin/rhodecode_bin/bin/rc-upgrade-db /etc/rhodecode/conf/rhodecode.ini --force-yes"
   fi
 
   ./$RC_SCRIPT_NAME stack rhodecode exec rhodecode /usr/local/bin/rhodecode_bin/bin/rc-upgrade-db /etc/rhodecode/conf/rhodecode.ini --force-yes
 }
 
 # :command.function
 rcstack_cli_storage_command() {
   # src/cli_storage_command.sh
   check_bootstrap
 
   DEBUG=${args[--debug]}
   ENV_FILE=${args[--env-file-path]}
 
   if [[ $DEBUG ]]; then
     echo "rc_datavolume inspection..."
     docker volume inspect rc_datavolume
 
     echo "rc_reposvolume inspection..."
     docker volume inspect rc_reposvolume
   fi
 
   #
   #if [[ $DEBUG ]]; then
   #  echo "image id: $image_id, based on $target_container filter"
   #  docker image ls
   #  echo "---"
   #fi
   # rename a volume
   #docker volume create --name <new_volume>
   #docker run --rm -it -v <old_volume>:/from -v <new_volume>:/to alpine ash -c "cd /from ; cp -av . /to"
   #docker volume rm <old_volume>
 
   printf "attaching rc_datavolume \t\tunder: /vol/datavolume\n"
   printf "attaching rc_reposvolume \t\tunder: /vol/repovolume\n"
   printf "attaching \$PWD.custom/storage \t\tunder: /vol/backupvolume\n"
 
   docker run --rm \
     -it \
     --volume $PWD/.custom/storage:/vol/backupvolume \
     --volume rc_datavolume:/vol/datavolume \
     --volume rc_reposvolume:/vol/repovolume \
     --workdir="/vol" \
     ubuntu:22.04 \
     /bin/bash
 
 }
 
 # :command.function
 rcstack_cli_attach_command() {
   # src/cli_attach_command.sh
   instance_type=${args[--instance-type]}
 
   match_name=rc_cluster_apps-$instance_type
   docker_id=$(docker ps --filter name=$match_name -q | head -n1)
 
   if [[ $docker_id == "" ]]; then
     echo "$(yellow cannot find instance to attach by name *$match_name*)"
     exit 1
   fi
 
   docker exec -it --tty $docker_id bash
 
 }
 
 # :command.function
 rcstack_cli_configure_vcsserver_command() {
   # src/cli_configure_vcsserver_command.sh
   ini_path=${args[ini_path]}
   DEBUG=${args[--debug]}
 
   sed_replace() {
 
     if [[ $DEBUG ]]; then
       echo "pat1: $1"
       echo "pat1: $2"
       echo
       echo "sed --in-place=.replaced -E \"s/$1/$2/\" $ini_path"
     fi
 
     sed --in-place=.replaced -E "s/$1/$2/" $ini_path
   }
 
   config_vcsserver_ini
 
   echo
   echo "reconfigure of $ini_path completed"
 
 }
 
 # :command.function
 rcstack_cli_configure_rhodecode_command() {
   # src/cli_configure_rhodecode_command.sh
   ini_path=${args[ini_path]}
   DEBUG=${args[--debug]}
 
   sed_replace() {
 
     if [[ $DEBUG ]]; then
       echo "pat1: $1"
       echo "pat1: $2"
       echo
       echo "sed --in-place=.replaced -E \"s/$1/$2/\" $ini_path"
     fi
 
     sed --in-place=.replaced -E "s/$1/$2/" $ini_path
   }
 
   # read generated secrets etc from our .env file
   .env --file $RUNTIME_ENV
 
   .env get RC_LICENSE_TOKEN
   RC_LICENSE_TOKEN=$REPLY
 
   .env get RC_HOSTNAME
   RC_HOSTNAME=$REPLY
 
   config_rhodecode_ini
 
   echo
   echo "reconfigure of $ini_path completed"
 }
 
 # :command.function
 rcstack_backup_db_command() {
   # src/backup_db_command.sh
   check_bootstrap
 
   DEBUG=${args[--debug]}
   DESTINATION=${args[destination]}
 
   backup_name=rc_db_dump-$(date +%Y-%m-%d).sql.gz
   echo "creating backup: $backup_name"
 
   target_container=rc_cluster_services-database-*
   docker_id=$(docker ps --filter name=$target_container -q | head -n1)
 
   if [[ $DEBUG ]]; then
     echo "container id: $docker_id, based on $target_container filter"
     docker ps
     echo "---"
   fi
 
   if [ "$docker_id" == "" ]; then
     MSG="Cannot find container ID with name $target_container"
     echo "$(red $MSG)"
     exit 1
   fi
 
   .env --file $RUNTIME_ENV
 
   .env get DB_PASSWORD
   DB_PASSWORD=$REPLY
 
   .env get DB_NAME
   DB_NAME=$REPLY
 
   .env get DB_USER
   DB_USER=$REPLY
 
   if [[ $DEBUG ]]; then
     echo "docker exec -e PGPASSWORD=$DB_PASSWORD $docker_id /bin/bash -c 'mkdir -p /var/rc-data-dump && pg_dump --inserts -U $DB_USER -h 127.0.0.1 --dbname=$DB_NAME | gzip > /var/rc-data-dump/$backup_name'"
     echo "dump placed in /var/rc-data-dump/$backup_name"
     echo "run docker cp $docker_id:/var/rc-data-dump/$backup_name $PWD to copy the file into your host machine"
   fi
 
   set -euo pipefail
 
   docker exec -e PGPASSWORD=$DB_PASSWORD $docker_id /bin/bash -c "pg_dump --inserts -U $DB_USER -h 127.0.0.1 --dbname=$DB_NAME | gzip > /var/rc-data-dump/$backup_name"
 
   echo "$(green Backup created in container volume under: /var/rc-data-dump/$backup_name !)"
   echo "to copy this file into your host machine run:"
   echo "docker cp $docker_id:/var/rc-data-dump/$backup_name $PWD"
 
 }
 
 # :command.function
 rcstack_backup_data_command() {
   # src/backup_data_command.sh
   check_bootstrap
 
   DEBUG=${args[--debug]}
   DESTINATION=${args[destination]}
 
   backup_name=rc_data_dump-$(date +%Y-%m-%d).tar.gz
   echo "creating backup: $backup_name"
 
   target_container=rc_cluster_apps-rhodecode-*
   target_container=rc_cluster_apps-celery-*
   docker_id=$(docker ps --filter name=$target_container -q | head -n1)
 
   if [[ $DEBUG ]]; then
     echo "container id: $docker_id, based on $target_container filter"
     docker ps
     echo "---"
   fi
 
   if [ "$docker_id" == "" ]; then
     MSG="Cannot find container ID with name $target_container"
     echo "$(red $MSG)"
     exit 1
   fi
 
   set -euo pipefail
 
   echo "Following volumes will be backed-up:"
 
   volumes=$(docker inspect --format "{{ range .Mounts }}{{ println .Destination }}{{ end }}" $docker_id)
   destination_dir=/tmp
   for vol in $volumes; do
     echo "backup: $vol"
     docker run --rm -v $destination_dir:/backup --volumes-from "$docker_id" debian:jessie tar -czvf /backup/$backup_name.tar.gz "$vol"
   done
 
   echo "$(green Backup created in $destination_dir: $backup_name !)"
 
   #docker-volume-restore-compressed() {
   #  destination_dir=$1
   #  container=$2
   #
   #  docker run --rm -v $destination_dir:/backup --volumes-from "$container" debian:jessie tar -xzvf /backup/backup.tar.gz "${@:3}"
   #  echo "Double checking files..."
   #  docker run --rm -v $destination_dir:/backup --volumes-from "$container" debian:jessie ls -lh "${@:2}"
   #}
 }
 
 # :command.function
 rcstack_get_build_artifacts_command() {
   # src/get_build_artifacts_command.sh
   check_bootstrap
 
   DEBUG=${args[--debug]}
   AUTH=${args[--auth]}
   INSTALLER_URL=${args[--installer-url]}
   MANIFEST_URL=${args[--manifest-url]}
   RC_VERSION=${args[--version-name]}
   VER=$RC_VERSION
 
   CACHE_DIR=$PWD/.cache
   VER_REGEX="$VER+x86_64"
 
   if [[ $VER == "" ]]; then
     msg="Version is empty, please set --version-name correctly"
     echo "$(red $msg)"
     exit 1
   fi
 
   echo "Downloading Artifacts for version: $VER"
   mkdir -p $CACHE_DIR
 
   echo "1/4 Checking available downloads from MANIFEST file"
 
   ARTS=$(curl -s $AUTH $MANIFEST_URL | grep --ignore-case "$VER_REGEX" | cut -d ' ' -f 2)
 
   if [[ $DEBUG ]]; then
     echo "DEBUG START"
     curl -s $AUTH $MANIFEST_URL | grep --ignore-case "$VER_REGEX" || echo "no regex match"
     curl -s $AUTH $MANIFEST_URL | grep --ignore-case "$VER_REGEX" | cut -d ' ' -f 2
     echo "Found following artifacts:"
     echo $ARTS
     echo "DEBUG END"
   fi
 
   if [[ $ARTS == "" ]]; then
     MSG="Failed to found any MANIFEST entries for version $VER make sure there exists release with that version or use --version to specify different version"
     echo "$(red $MSG)"
     exit 1
   fi
 
   echo "2/4 Downloading locale-archive"
   curl -L https://dls.rhodecode.com/assets/locale-archive -J -O
   mv -v locale-archive "$CACHE_DIR"
 
   # vcsserver/ce/ee
   echo "3/4 Downloading installer artifacts"
   for url in $ARTS; do
       echo "Downloading $url with $AUTH"
       curl $AUTH --fail-early -L ${url} -J -O
   done
 
   #for url in $(curl -s $MANIFEST_URL | grep --ignore-case -E 'control.+\+x86_64' | cut -d ' ' -f 2); do
   #    echo "Downloading $url"
   #    curl -L ${url} -J -O
   #done
 
   echo "4/4 Downloading installer from $INSTALLER_URL"
   curl $AUTH -L $INSTALLER_URL -J -O
 
   INSTALLER=$(ls -Art RhodeCode-installer-* | tail -n 1)
   if [[ -n $INSTALLER ]]; then
     chmod +x "${INSTALLER}"
   fi
 
   echo "Copying artifacts into $CACHE_DIR"
 
   mv -v "${INSTALLER}" $CACHE_DIR
   mv -v *.bz2 $CACHE_DIR
   ls -lh $CACHE_DIR
 
 }
 
 # :command.function
 rcstack_build_installer_command() {
   # src/build_installer_command.sh
   check_bootstrap
 
   rc_version=${args[--version-name]}
   export RC_VERSION=$rc_version
   eval "echo INSTALLER BASED BUILDING${RC_VERSION}"
 
   RC_VERSION=$rc_version ./$RC_SCRIPT_NAME stack rhodecode build --progress plain rhodecode
 
 }
 
 # :command.function
 rcstack_get_build_source_command() {
   # src/get_build_source_command.sh
 
   NO_INIT=${args[--no-init-check]}
 
   if [[ ! $NO_INIT ]]; then
     check_bootstrap
   fi
 
   DEBUG=${args[--debug]}
   AUTH_TOKEN=${args[--auth-token]}
   SERVER_URL=${args[--server-url]}
   revision=${args[--revision]}
 
   SOURCE_DIR=$PWD/.source
 
   RHODECODE_VCS_HASH=$revision
   RHODECODE_CE_HASH=$revision
   RHODECODE_EE_HASH=$revision
 
   # download sources
   echo "** download rhodecode source for build from $SERVER_URL using '$revision' hash **"
   mkdir -p $SOURCE_DIR
 
   echo "getting $SERVER_URL/rhodecode-vcsserver/archive/$RHODECODE_VCS_HASH.tgz"
   curl --fail --header "X-Rc-Auth-Token: $AUTH_TOKEN" -L $SERVER_URL/rhodecode-vcsserver/archive/$RHODECODE_VCS_HASH.tgz?with_hash=0 | tar -xz -C $SOURCE_DIR
 
   echo "getting $SERVER_URL/rhodecode-enterprise-ce/archive/$RHODECODE_CE_HASH.tgz"
   curl --fail --header "X-Rc-Auth-Token: $AUTH_TOKEN" -L $SERVER_URL/rhodecode-enterprise-ce/archive/$RHODECODE_CE_HASH.tgz?with_hash=0 | tar -xz -C $SOURCE_DIR
 
   echo "getting $SERVER_URL/rhodecode-enterprise-ee/archive/$RHODECODE_EE_HASH.tgz"
   curl --fail --header "X-Rc-Auth-Token: $AUTH_TOKEN" -L $SERVER_URL/rhodecode-enterprise-ee/archive/$RHODECODE_EE_HASH.tgz?with_hash=0 | tar -xz -C $SOURCE_DIR
 
   rm -rf $SOURCE_DIR/rhodecode-vcsserver && \
   mv  $SOURCE_DIR/*rhodecode-vcsserver-plain     $SOURCE_DIR/rhodecode-vcsserver
   rm -rf $SOURCE_DIR/rhodecode-vcsserver/.hg
 
   rm -rf $SOURCE_DIR/rhodecode-enterprise-ce && \
   mv  $SOURCE_DIR/*rhodecode-enterprise-ce-plain $SOURCE_DIR/rhodecode-enterprise-ce
   rm -rf $SOURCE_DIR/rhodecode-enterprise-ce/.hg
 
   rm -rf $SOURCE_DIR/rhodecode-enterprise-ee && \
   mv  $SOURCE_DIR/*rhodecode-enterprise-ee-plain $SOURCE_DIR/rhodecode-enterprise-ee
   rm -rf $SOURCE_DIR/rhodecode-enterprise-ee/.hg
 
   echo "downloading sources done to $SOURCE_DIR, directory now consists:"
   ls -l $SOURCE_DIR
 
   echo ""
   date_formatted=$(date +%Y.%m.%d.1)
   echo "to create source based build run:"
   echo "  ./$RC_SCRIPT_NAME build-source --version-name 4.28.0.REL.$date_formatted --tag edge"
 
 }
 
 # :command.function
 rcstack_build_source_command() {
   # src/build_source_command.sh
   check_bootstrap
   .env --file $RUNTIME_ENV
 
   .env get RC_EDITION
   rc_edition=$REPLY
 
   rc_version=${args[--version-name]}
   eval "tags_data=(${args[--tag]})"
 
   export RC_VERSION=$rc_version
   export RC_EDITION=$rc_edition
   echo "build_source: SOURCE BASED BUILDING: $rc_version"
   echo ""
 
   DOCKER_SCAN_SUGGEST=false RC_VERSION=$rc_version ./$RC_SCRIPT_NAME stack rhodecode -f docker-compose-apps.source.yaml build --progress plain rhodecode
 
   for tag in "${tags_data[@]}"; do
     echo "build_source: creating tag:$tag"
     docker tag rhodecode/rhodecode-$rc_edition:$rc_version rhodecode/rhodecode-$rc_edition:$tag
   done
 
   echo "build_source: consider setting release version using"
   echo "  ./$RC_SCRIPT_NAME cli image-info --set-runtime $rc_version"
 
   echo "build_source: push this image using"
   echo "  docker push rhodecode/rhodecode-$rc_edition:$rc_version"
 
 }
 
 # :command.function
 rcstack__completions_command() {
   # src/_completions_command.sh
   send_completions
 }
 
 # :command.parse_requirements
 parse_requirements() {
   # :command.fixed_flags_filter
   while [[ $# -gt 0 ]]; do
     case "${1:-}" in
       --version | -v)
         version_command
         exit
         ;;
 
       --help | -h)
         long_usage=yes
         rcstack_usage
         exit
         ;;
 
       # :flag.case
       --debug)
 
         # :flag.case_no_arg
         args['--debug']=1
         shift
         ;;
 
       # :flag.case
       --no-init-check)
 
         # :flag.case_no_arg
         args['--no-init-check']=1
         shift
         ;;
 
       *)
         break
         ;;
 
     esac
   done
 
   # :command.environment_variables_filter
   # :command.environment_variables_default
   export RCC_CONFIG="${RCC_CONFIG:-.rcstack.ini}"
   export RC_STACK_ROUTER_EXT="${RC_STACK_ROUTER_EXT:-.custom/docker-compose-router.override.yaml}"
   export RC_STACK_METRICS_EXT="${RC_STACK_METRICS_EXT:-.custom/docker-compose-metrics.override.yaml}"
   export RC_STACK_SERVICES_EXT="${RC_STACK_SERVICES_EXT:-.custom/docker-compose-services.override.yaml}"
   export RC_STACK_RHODECODE_EXT="${RC_STACK_RHODECODE_EXT:-.custom/docker-compose-apps.override.yaml}"
 
   # :command.command_filter
   action=${1:-}
 
   case $action in
     -*) ;;
 
     get-started)
       action="get-started"
       shift
       rcstack_get_started_parse_requirements "$@"
       shift $#
       ;;
 
     init)
       action="init"
       shift
       rcstack_init_parse_requirements "$@"
       shift $#
       ;;
 
     self-update)
       action="self-update"
       shift
       rcstack_self_update_parse_requirements "$@"
       shift $#
       ;;
 
     stack)
       action="stack"
       shift
       rcstack_stack_parse_requirements "$@"
       shift $#
       ;;
 
     stack-status | status)
       action="stack-status"
       shift
       rcstack_stack_status_parse_requirements "$@"
       shift $#
       ;;
 
     stack-upgrade)
       action="stack-upgrade"
       shift
       rcstack_stack_upgrade_parse_requirements "$@"
       shift $#
       ;;
 
     cli)
       action="cli"
       shift
       rcstack_cli_parse_requirements "$@"
       shift $#
       ;;
 
     backup-db)
       action="backup-db"
       shift
       rcstack_backup_db_parse_requirements "$@"
       shift $#
       ;;
 
     backup-data)
       action="backup-data"
       shift
       rcstack_backup_data_parse_requirements "$@"
       shift $#
       ;;
 
     get-build-artifacts)
       action="get-build-artifacts"
       shift
       rcstack_get_build_artifacts_parse_requirements "$@"
       shift $#
       ;;
 
     build-installer)
       action="build-installer"
       shift
       rcstack_build_installer_parse_requirements "$@"
       shift $#
       ;;
 
     get-build-source)
       action="get-build-source"
       shift
       rcstack_get_build_source_parse_requirements "$@"
       shift $#
       ;;
 
     build-source)
       action="build-source"
       shift
       rcstack_build_source_parse_requirements "$@"
       shift $#
       ;;
 
     _completions)
       action="_completions"
       shift
       rcstack__completions_parse_requirements "$@"
       shift $#
       ;;
 
     # :command.command_fallback
     "")
       rcstack_usage >&2
       exit 1
       ;;
 
     *)
       printf "invalid command: %s\n" "$action" >&2
       exit 1
       ;;
 
   esac
 
   # :command.parse_requirements_while
   while [[ $# -gt 0 ]]; do
     key="$1"
     case "$key" in
 
       -?*)
         printf "invalid option: %s\n" "$key" >&2
         exit 1
         ;;
 
       *)
         # :command.parse_requirements_case
         # :command.parse_requirements_case_simple
         printf "invalid argument: %s\n" "$key" >&2
         exit 1
 
         ;;
 
     esac
   done
 
 }
 
 # :command.parse_requirements
 rcstack_get_started_parse_requirements() {
   # :command.fixed_flags_filter
   while [[ $# -gt 0 ]]; do
     case "${1:-}" in
       --help | -h)
         long_usage=yes
         rcstack_get_started_usage
         exit
         ;;
 
       *)
         break
         ;;
 
     esac
   done
 
   # :command.command_filter
   action="get-started"
 
   # :command.parse_requirements_while
   while [[ $# -gt 0 ]]; do
     key="$1"
     case "$key" in
 
       -?*)
         printf "invalid option: %s\n" "$key" >&2
         exit 1
         ;;
 
       *)
         # :command.parse_requirements_case
         # :command.parse_requirements_case_simple
         printf "invalid argument: %s\n" "$key" >&2
         exit 1
 
         ;;
 
     esac
   done
 
 }
 
 # :command.parse_requirements
 rcstack_init_parse_requirements() {
   # :command.fixed_flags_filter
   while [[ $# -gt 0 ]]; do
     case "${1:-}" in
       --help | -h)
         long_usage=yes
         rcstack_init_usage
         exit
         ;;
 
       *)
         break
         ;;
 
     esac
   done
 
   # :command.dependencies_filter
   if ! command -v curl >/dev/null 2>&1; then
     printf "missing dependency: curl\n" >&2
     exit 1
   fi
 
   if ! command -v tar >/dev/null 2>&1; then
     printf "missing dependency: tar\n" >&2
     exit 1
   fi
 
   if ! command -v md5sum >/dev/null 2>&1; then
     printf "missing dependency: md5sum\n" >&2
     exit 1
   fi
 
   if ! command -v find >/dev/null 2>&1; then
     printf "missing dependency: find\n" >&2
     exit 1
   fi
 
   # :command.command_filter
   action="init"
 
   # :command.parse_requirements_while
   while [[ $# -gt 0 ]]; do
     key="$1"
     case "$key" in
       # :flag.case
       --force | -f)
 
         # :flag.case_no_arg
         args['--force']=1
         shift
         ;;
 
       # :flag.case
       --auth-token)
 
         # :flag.case_arg
         if [[ -n ${2+x} ]]; then
 
           args['--auth-token']="$2"
           shift
           shift
         else
           printf "%s\n" "--auth-token requires an argument: --auth-token AUTH_TOKEN" >&2
           exit 1
         fi
         ;;
 
       # :flag.case
       --server-url)
 
         # :flag.case_arg
         if [[ -n ${2+x} ]]; then
 
           args['--server-url']="$2"
           shift
           shift
         else
           printf "%s\n" "--server-url requires an argument: --server-url SERVER_URL" >&2
           exit 1
         fi
         ;;
 
       # :flag.case
       --revision)
 
         # :flag.case_arg
         if [[ -n ${2+x} ]]; then
 
           args['--revision']="$2"
           shift
           shift
         else
           printf "%s\n" "--revision requires an argument: --revision REVISION" >&2
           exit 1
         fi
         ;;
 
       # :flag.case
       --install-docker)
 
         # :flag.case_arg
         if [[ -n ${2+x} ]]; then
 
           args['--install-docker']="$2"
           shift
           shift
         else
           printf "%s\n" "--install-docker requires an argument: --install-docker INSTALL_DOCKER" >&2
           exit 1
         fi
         ;;
 
       -?*)
         printf "invalid option: %s\n" "$key" >&2
         exit 1
         ;;
 
       *)
         # :command.parse_requirements_case
         # :command.parse_requirements_case_simple
         printf "invalid argument: %s\n" "$key" >&2
         exit 1
 
         ;;
 
     esac
   done
 
   # :command.default_assignments
   [[ -n ${args['--server-url']:-} ]] || args['--server-url']="https://code.rhodecode.com"
   [[ -n ${args['--revision']:-} ]] || args['--revision']="master"
 
 }
 
 # :command.parse_requirements
 rcstack_self_update_parse_requirements() {
   # :command.fixed_flags_filter
   while [[ $# -gt 0 ]]; do
     case "${1:-}" in
       --help | -h)
         long_usage=yes
         rcstack_self_update_usage
         exit
         ;;
 
       *)
         break
         ;;
 
     esac
   done
 
   # :command.dependencies_filter
   if ! command -v curl >/dev/null 2>&1; then
     printf "missing dependency: curl\n" >&2
     exit 1
   fi
 
   if ! command -v tar >/dev/null 2>&1; then
     printf "missing dependency: tar\n" >&2
     exit 1
   fi
 
   # :command.command_filter
   action="self-update"
 
   # :command.parse_requirements_while
   while [[ $# -gt 0 ]]; do
     key="$1"
     case "$key" in
       # :flag.case
       --installer-revision)
 
         # :flag.case_arg
         if [[ -n ${2+x} ]]; then
 
           args['--installer-revision']="$2"
           shift
           shift
         else
           printf "%s\n" "--installer-revision requires an argument: --installer-revision INSTALLER_REVISION" >&2
           exit 1
         fi
         ;;
 
       # :flag.case
       --revision)
 
         # :flag.case_arg
         if [[ -n ${2+x} ]]; then
 
           args['--revision']="$2"
           shift
           shift
         else
           printf "%s\n" "--revision requires an argument: --revision REVISION" >&2
           exit 1
         fi
         ;;
 
       # :flag.case
       --auth-token)
 
         # :flag.case_arg
         if [[ -n ${2+x} ]]; then
 
           args['--auth-token']="$2"
           shift
           shift
         else
           printf "%s\n" "--auth-token requires an argument: --auth-token AUTH_TOKEN" >&2
           exit 1
         fi
         ;;
 
       # :flag.case
       --server-url)
 
         # :flag.case_arg
         if [[ -n ${2+x} ]]; then
 
           args['--server-url']="$2"
           shift
           shift
         else
           printf "%s\n" "--server-url requires an argument: --server-url SERVER_URL" >&2
           exit 1
         fi
         ;;
 
       -?*)
         printf "invalid option: %s\n" "$key" >&2
         exit 1
         ;;
 
       *)
         # :command.parse_requirements_case
         # :command.parse_requirements_case_simple
         printf "invalid argument: %s\n" "$key" >&2
         exit 1
 
         ;;
 
     esac
   done
 
   # :command.default_assignments
   [[ -n ${args['--installer-revision']:-} ]] || args['--installer-revision']="master"
   [[ -n ${args['--revision']:-} ]] || args['--revision']="master"
   [[ -n ${args['--server-url']:-} ]] || args['--server-url']="https://code.rhodecode.com"
 
 }
 
 # :command.parse_requirements
 rcstack_stack_parse_requirements() {
   # :command.fixed_flags_filter
   while [[ $# -gt 0 ]]; do
     case "${1:-}" in
       --help | -h)
         long_usage=yes
         rcstack_stack_usage
         exit
         ;;
 
       # :flag.case
       --env-file-path)
 
         # :flag.case_arg
         if [[ -n ${2+x} ]]; then
 
           args['--env-file-path']="$2"
           shift
           shift
         else
           printf "%s\n" "--env-file-path requires an argument: --env-file-path ENV_FILE_PATH" >&2
           exit 1
         fi
         ;;
 
       *)
         break
         ;;
 
     esac
   done
 
   # :command.command_filter
   action=${1:-}
 
   case $action in
     -*) ;;
 
     router)
       action="router"
       shift
       rcstack_stack_router_parse_requirements "$@"
       shift $#
       ;;
 
     metrics)
       action="metrics"
       shift
       rcstack_stack_metrics_parse_requirements "$@"
       shift $#
       ;;
 
     services)
       action="services"
       shift
       rcstack_stack_services_parse_requirements "$@"
       shift $#
       ;;
 
     rhodecode)
       action="rhodecode"
       shift
       rcstack_stack_rhodecode_parse_requirements "$@"
       shift $#
       ;;
 
     all)
       action="all"
       shift
       rcstack_stack_all_parse_requirements "$@"
       shift $#
       ;;
 
     # :command.command_fallback
     "")
       rcstack_stack_usage >&2
       exit 1
       ;;
 
     *)
       printf "invalid command: %s\n" "$action" >&2
       exit 1
       ;;
 
   esac
 
   # :command.parse_requirements_while
   while [[ $# -gt 0 ]]; do
     key="$1"
     case "$key" in
 
       -?*)
         printf "invalid option: %s\n" "$key" >&2
         exit 1
         ;;
 
       *)
         # :command.parse_requirements_case
         # :command.parse_requirements_case_simple
         printf "invalid argument: %s\n" "$key" >&2
         exit 1
 
         ;;
 
     esac
   done
 
   # :command.default_assignments
   [[ -n ${args['--env-file-path']:-} ]] || args['--env-file-path']="$PWD/.custom/.runtime.env"
 
 }
 
 # :command.parse_requirements
 rcstack_stack_router_parse_requirements() {
   # :command.fixed_flags_filter
   while [[ $# -gt 0 ]]; do
     case "${1:-}" in
       --help | -h)
         long_usage=yes
         rcstack_stack_router_usage
         exit
         ;;
 
       *)
         break
         ;;
 
     esac
   done
 
   # :command.command_filter
   action="stack router"
 
   # :command.parse_requirements_while
   while [[ $# -gt 0 ]]; do
     key="$1"
     case "$key" in
 
       --)
         shift
         other_args+=("$@")
         break
         ;;
 
       -?*)
         other_args+=("$1")
         shift
         ;;
 
       *)
         # :command.parse_requirements_case
         # :command.parse_requirements_case_catch_all
         other_args+=("$1")
         shift
 
         ;;
 
     esac
   done
 
 }
 
 # :command.parse_requirements
 rcstack_stack_metrics_parse_requirements() {
   # :command.fixed_flags_filter
   while [[ $# -gt 0 ]]; do
     case "${1:-}" in
       --help | -h)
         long_usage=yes
         rcstack_stack_metrics_usage
         exit
         ;;
 
       *)
         break
         ;;
 
     esac
   done
 
   # :command.command_filter
   action="stack metrics"
 
   # :command.parse_requirements_while
   while [[ $# -gt 0 ]]; do
     key="$1"
     case "$key" in
 
       --)
         shift
         other_args+=("$@")
         break
         ;;
 
       -?*)
         other_args+=("$1")
         shift
         ;;
 
       *)
         # :command.parse_requirements_case
         # :command.parse_requirements_case_catch_all
         other_args+=("$1")
         shift
 
         ;;
 
     esac
   done
 
 }
 
 # :command.parse_requirements
 rcstack_stack_services_parse_requirements() {
   # :command.fixed_flags_filter
   while [[ $# -gt 0 ]]; do
     case "${1:-}" in
       --help | -h)
         long_usage=yes
         rcstack_stack_services_usage
         exit
         ;;
 
       *)
         break
         ;;
 
     esac
   done
 
   # :command.command_filter
   action="stack services"
 
   # :command.parse_requirements_while
   while [[ $# -gt 0 ]]; do
     key="$1"
     case "$key" in
 
       --)
         shift
         other_args+=("$@")
         break
         ;;
 
       -?*)
         other_args+=("$1")
         shift
         ;;
 
       *)
         # :command.parse_requirements_case
         # :command.parse_requirements_case_catch_all
         other_args+=("$1")
         shift
 
         ;;
 
     esac
   done
 
 }
 
 # :command.parse_requirements
 rcstack_stack_rhodecode_parse_requirements() {
   # :command.fixed_flags_filter
   while [[ $# -gt 0 ]]; do
     case "${1:-}" in
       --help | -h)
         long_usage=yes
         rcstack_stack_rhodecode_usage
         exit
         ;;
 
       *)
         break
         ;;
 
     esac
   done
 
   # :command.command_filter
   action="stack rhodecode"
 
   # :command.parse_requirements_while
   while [[ $# -gt 0 ]]; do
     key="$1"
     case "$key" in
 
       --)
         shift
         other_args+=("$@")
         break
         ;;
 
       -?*)
         other_args+=("$1")
         shift
         ;;
 
       *)
         # :command.parse_requirements_case
         # :command.parse_requirements_case_catch_all
         other_args+=("$1")
         shift
 
         ;;
 
     esac
   done
 
 }
 
 # :command.parse_requirements
 rcstack_stack_all_parse_requirements() {
   # :command.fixed_flags_filter
   while [[ $# -gt 0 ]]; do
     case "${1:-}" in
       --help | -h)
         long_usage=yes
         rcstack_stack_all_usage
         exit
         ;;
 
       *)
         break
         ;;
 
     esac
   done
 
   # :command.command_filter
   action="stack all"
 
   # :command.parse_requirements_while
   while [[ $# -gt 0 ]]; do
     key="$1"
     case "$key" in
 
       --)
         shift
         other_args+=("$@")
         break
         ;;
 
       -?*)
         other_args+=("$1")
         shift
         ;;
 
       *)
         # :command.parse_requirements_case
         # :command.parse_requirements_case_catch_all
         other_args+=("$1")
         shift
 
         ;;
 
     esac
   done
 
 }
 
 # :command.parse_requirements
 rcstack_stack_status_parse_requirements() {
   # :command.fixed_flags_filter
   while [[ $# -gt 0 ]]; do
     case "${1:-}" in
       --help | -h)
         long_usage=yes
         rcstack_stack_status_usage
         exit
         ;;
 
       *)
         break
         ;;
 
     esac
   done
 
   # :command.command_filter
   action="stack-status"
 
   # :command.parse_requirements_while
   while [[ $# -gt 0 ]]; do
     key="$1"
     case "$key" in
       # :flag.case
       --detailed)
 
         # :flag.case_no_arg
         args['--detailed']=1
         shift
         ;;
 
       -?*)
         printf "invalid option: %s\n" "$key" >&2
         exit 1
         ;;
 
       *)
         # :command.parse_requirements_case
         # :command.parse_requirements_case_simple
         printf "invalid argument: %s\n" "$key" >&2
         exit 1
 
         ;;
 
     esac
   done
 
 }
 
 # :command.parse_requirements
 rcstack_stack_upgrade_parse_requirements() {
   # :command.fixed_flags_filter
   while [[ $# -gt 0 ]]; do
     case "${1:-}" in
       --help | -h)
         long_usage=yes
         rcstack_stack_upgrade_usage
         exit
         ;;
 
       *)
         break
         ;;
 
     esac
   done
 
   # :command.command_filter
   action=${1:-}
 
   case $action in
     -*) ;;
 
     router)
       action="router"
       shift
       rcstack_stack_upgrade_router_parse_requirements "$@"
       shift $#
       ;;
 
     metrics)
       action="metrics"
       shift
       rcstack_stack_upgrade_metrics_parse_requirements "$@"
       shift $#
       ;;
 
     services)
       action="services"
       shift
       rcstack_stack_upgrade_services_parse_requirements "$@"
       shift $#
       ;;
 
     rhodecode)
       action="rhodecode"
       shift
       rcstack_stack_upgrade_rhodecode_parse_requirements "$@"
       shift $#
       ;;
 
     # :command.command_fallback
     "")
       rcstack_stack_upgrade_usage >&2
       exit 1
       ;;
 
     *)
       printf "invalid command: %s\n" "$action" >&2
       exit 1
       ;;
 
   esac
 
   # :command.parse_requirements_while
   while [[ $# -gt 0 ]]; do
     key="$1"
     case "$key" in
 
       -?*)
         printf "invalid option: %s\n" "$key" >&2
         exit 1
         ;;
 
       *)
         # :command.parse_requirements_case
         # :command.parse_requirements_case_simple
         printf "invalid argument: %s\n" "$key" >&2
         exit 1
 
         ;;
 
     esac
   done
 
 }
 
 # :command.parse_requirements
 rcstack_stack_upgrade_router_parse_requirements() {
   # :command.fixed_flags_filter
   while [[ $# -gt 0 ]]; do
     case "${1:-}" in
       --help | -h)
         long_usage=yes
         rcstack_stack_upgrade_router_usage
         exit
         ;;
 
       *)
         break
         ;;
 
     esac
   done
 
   # :command.command_filter
   action="stack-upgrade router"
 
   # :command.parse_requirements_while
   while [[ $# -gt 0 ]]; do
     key="$1"
     case "$key" in
 
       -?*)
         printf "invalid option: %s\n" "$key" >&2
         exit 1
         ;;
 
       *)
         # :command.parse_requirements_case
         # :command.parse_requirements_case_simple
         printf "invalid argument: %s\n" "$key" >&2
         exit 1
 
         ;;
 
     esac
   done
 
 }
 
 # :command.parse_requirements
 rcstack_stack_upgrade_metrics_parse_requirements() {
   # :command.fixed_flags_filter
   while [[ $# -gt 0 ]]; do
     case "${1:-}" in
       --help | -h)
         long_usage=yes
         rcstack_stack_upgrade_metrics_usage
         exit
         ;;
 
       *)
         break
         ;;
 
     esac
   done
 
   # :command.command_filter
   action="stack-upgrade metrics"
 
   # :command.parse_requirements_while
   while [[ $# -gt 0 ]]; do
     key="$1"
     case "$key" in
 
       -?*)
         printf "invalid option: %s\n" "$key" >&2
         exit 1
         ;;
 
       *)
         # :command.parse_requirements_case
         # :command.parse_requirements_case_simple
         printf "invalid argument: %s\n" "$key" >&2
         exit 1
 
         ;;
 
     esac
   done
 
 }
 
 # :command.parse_requirements
 rcstack_stack_upgrade_services_parse_requirements() {
   # :command.fixed_flags_filter
   while [[ $# -gt 0 ]]; do
     case "${1:-}" in
       --help | -h)
         long_usage=yes
         rcstack_stack_upgrade_services_usage
         exit
         ;;
 
       *)
         break
         ;;
 
     esac
   done
 
   # :command.command_filter
   action="stack-upgrade services"
 
   # :command.parse_requirements_while
   while [[ $# -gt 0 ]]; do
     key="$1"
     case "$key" in
 
       -?*)
         printf "invalid option: %s\n" "$key" >&2
         exit 1
         ;;
 
       *)
         # :command.parse_requirements_case
         # :command.parse_requirements_case_simple
         printf "invalid argument: %s\n" "$key" >&2
         exit 1
 
         ;;
 
     esac
   done
 
 }
 
 # :command.parse_requirements
 rcstack_stack_upgrade_rhodecode_parse_requirements() {
   # :command.fixed_flags_filter
   while [[ $# -gt 0 ]]; do
     case "${1:-}" in
       --help | -h)
         long_usage=yes
         rcstack_stack_upgrade_rhodecode_usage
         exit
         ;;
 
       *)
         break
         ;;
 
     esac
   done
 
   # :command.command_filter
   action="stack-upgrade rhodecode"
 
   # :command.parse_requirements_while
   while [[ $# -gt 0 ]]; do
     key="$1"
     case "$key" in
       # :flag.case
       --restart-unhealthy)
 
         # :flag.case_no_arg
         args['--restart-unhealthy']=1
         shift
         ;;
 
       # :flag.case
       --stop-wait)
 
         # :flag.case_arg
         if [[ -n ${2+x} ]]; then
 
           args['--stop-wait']="$2"
           shift
           shift
         else
           printf "%s\n" "--stop-wait requires an argument: --stop-wait STOP_WAIT" >&2
           exit 1
         fi
         ;;
 
       -?*)
         printf "invalid option: %s\n" "$key" >&2
         exit 1
         ;;
 
       *)
         # :command.parse_requirements_case
         # :command.parse_requirements_case_simple
         printf "invalid argument: %s\n" "$key" >&2
         exit 1
 
         ;;
 
     esac
   done
 
   # :command.default_assignments
   [[ -n ${args['--stop-wait']:-} ]] || args['--stop-wait']="120"
 
 }
 
 # :command.parse_requirements
 rcstack_cli_parse_requirements() {
   # :command.fixed_flags_filter
   while [[ $# -gt 0 ]]; do
     case "${1:-}" in
       --help | -h)
         long_usage=yes
         rcstack_cli_usage
         exit
         ;;
 
       *)
         break
         ;;
 
     esac
   done
 
   # :command.command_filter
   action=${1:-}
 
   case $action in
     -*) ;;
 
     image-info)
       action="image-info"
       shift
       rcstack_cli_image_info_parse_requirements "$@"
       shift $#
       ;;
 
     redis)
       action="redis"
       shift
       rcstack_cli_redis_parse_requirements "$@"
       shift $#
       ;;
 
     db)
       action="db"
       shift
       rcstack_cli_db_parse_requirements "$@"
       shift $#
       ;;
 
     db-upgrade)
       action="db-upgrade"
       shift
       rcstack_cli_db_upgrade_parse_requirements "$@"
       shift $#
       ;;
 
     storage)
       action="storage"
       shift
       rcstack_cli_storage_parse_requirements "$@"
       shift $#
       ;;
 
     attach)
       action="attach"
       shift
       rcstack_cli_attach_parse_requirements "$@"
       shift $#
       ;;
 
     configure-vcsserver)
       action="configure-vcsserver"
       shift
       rcstack_cli_configure_vcsserver_parse_requirements "$@"
       shift $#
       ;;
 
     configure-rhodecode)
       action="configure-rhodecode"
       shift
       rcstack_cli_configure_rhodecode_parse_requirements "$@"
       shift $#
       ;;
 
     # :command.command_fallback
     "")
       rcstack_cli_usage >&2
       exit 1
       ;;
 
     *)
       printf "invalid command: %s\n" "$action" >&2
       exit 1
       ;;
 
   esac
 
   # :command.parse_requirements_while
   while [[ $# -gt 0 ]]; do
     key="$1"
     case "$key" in
 
       -?*)
         printf "invalid option: %s\n" "$key" >&2
         exit 1
         ;;
 
       *)
         # :command.parse_requirements_case
         # :command.parse_requirements_case_simple
         printf "invalid argument: %s\n" "$key" >&2
         exit 1
 
         ;;
 
     esac
   done
 
 }
 
 # :command.parse_requirements
 rcstack_cli_image_info_parse_requirements() {
   # :command.fixed_flags_filter
   while [[ $# -gt 0 ]]; do
     case "${1:-}" in
       --help | -h)
         long_usage=yes
         rcstack_cli_image_info_usage
         exit
         ;;
 
       *)
         break
         ;;
 
     esac
   done
 
   # :command.command_filter
   action="cli image-info"
 
   # :command.parse_requirements_while
   while [[ $# -gt 0 ]]; do
     key="$1"
     case "$key" in
       # :flag.case
       --set-runtime)
 
         # :flag.case_arg
         if [[ -n ${2+x} ]]; then
 
           args['--set-runtime']="$2"
           shift
           shift
         else
           printf "%s\n" "--set-runtime requires an argument: --set-runtime SET_RUNTIME" >&2
           exit 1
         fi
         ;;
 
       -?*)
         printf "invalid option: %s\n" "$key" >&2
         exit 1
         ;;
 
       *)
         # :command.parse_requirements_case
         # :command.parse_requirements_case_simple
         printf "invalid argument: %s\n" "$key" >&2
         exit 1
 
         ;;
 
     esac
   done
 
 }
 
 # :command.parse_requirements
 rcstack_cli_redis_parse_requirements() {
   # :command.fixed_flags_filter
   while [[ $# -gt 0 ]]; do
     case "${1:-}" in
       --help | -h)
         long_usage=yes
         rcstack_cli_redis_usage
         exit
         ;;
 
       *)
         break
         ;;
 
     esac
   done
 
   # :command.command_filter
   action="cli redis"
 
   # :command.parse_requirements_while
   while [[ $# -gt 0 ]]; do
     key="$1"
     case "$key" in
 
       -?*)
         printf "invalid option: %s\n" "$key" >&2
         exit 1
         ;;
 
       *)
         # :command.parse_requirements_case
         # :command.parse_requirements_case_simple
         printf "invalid argument: %s\n" "$key" >&2
         exit 1
 
         ;;
 
     esac
   done
 
 }
 
 # :command.parse_requirements
 rcstack_cli_db_parse_requirements() {
   # :command.fixed_flags_filter
   while [[ $# -gt 0 ]]; do
     case "${1:-}" in
       --help | -h)
         long_usage=yes
         rcstack_cli_db_usage
         exit
         ;;
 
       *)
         break
         ;;
 
     esac
   done
 
   # :command.command_filter
   action="cli db"
 
   # :command.parse_requirements_while
   while [[ $# -gt 0 ]]; do
     key="$1"
     case "$key" in
 
       -?*)
         printf "invalid option: %s\n" "$key" >&2
         exit 1
         ;;
 
       *)
         # :command.parse_requirements_case
         # :command.parse_requirements_case_simple
         printf "invalid argument: %s\n" "$key" >&2
         exit 1
 
         ;;
 
     esac
   done
 
 }
 
 # :command.parse_requirements
 rcstack_cli_db_upgrade_parse_requirements() {
   # :command.fixed_flags_filter
   while [[ $# -gt 0 ]]; do
     case "${1:-}" in
       --help | -h)
         long_usage=yes
         rcstack_cli_db_upgrade_usage
         exit
         ;;
 
       *)
         break
         ;;
 
     esac
   done
 
   # :command.command_filter
   action="cli db-upgrade"
 
   # :command.parse_requirements_while
   while [[ $# -gt 0 ]]; do
     key="$1"
     case "$key" in
 
       -?*)
         printf "invalid option: %s\n" "$key" >&2
         exit 1
         ;;
 
       *)
         # :command.parse_requirements_case
         # :command.parse_requirements_case_simple
         printf "invalid argument: %s\n" "$key" >&2
         exit 1
 
         ;;
 
     esac
   done
 
 }
 
 # :command.parse_requirements
 rcstack_cli_storage_parse_requirements() {
   # :command.fixed_flags_filter
   while [[ $# -gt 0 ]]; do
     case "${1:-}" in
       --help | -h)
         long_usage=yes
         rcstack_cli_storage_usage
         exit
         ;;
 
       *)
         break
         ;;
 
     esac
   done
 
   # :command.command_filter
   action="cli storage"
 
   # :command.parse_requirements_while
   while [[ $# -gt 0 ]]; do
     key="$1"
     case "$key" in
 
       -?*)
         printf "invalid option: %s\n" "$key" >&2
         exit 1
         ;;
 
       *)
         # :command.parse_requirements_case
         # :command.parse_requirements_case_simple
         printf "invalid argument: %s\n" "$key" >&2
         exit 1
 
         ;;
 
     esac
   done
 
 }
 
 # :command.parse_requirements
 rcstack_cli_attach_parse_requirements() {
   # :command.fixed_flags_filter
   while [[ $# -gt 0 ]]; do
     case "${1:-}" in
       --help | -h)
         long_usage=yes
         rcstack_cli_attach_usage
         exit
         ;;
 
       *)
         break
         ;;
 
     esac
   done
 
   # :command.command_filter
   action="cli attach"
 
   # :command.parse_requirements_while
   while [[ $# -gt 0 ]]; do
     key="$1"
     case "$key" in
       # :flag.case
       --instance-type)
 
         # :flag.case_arg
         if [[ -n ${2+x} ]]; then
 
           args['--instance-type']="$2"
           shift
           shift
         else
           printf "%s\n" "--instance-type requires an argument: --instance-type INSTANCE_TYPE" >&2
           exit 1
         fi
         ;;
 
       -?*)
         printf "invalid option: %s\n" "$key" >&2
         exit 1
         ;;
 
       *)
         # :command.parse_requirements_case
         # :command.parse_requirements_case_simple
         printf "invalid argument: %s\n" "$key" >&2
         exit 1
 
         ;;
 
     esac
   done
 
   # :command.default_assignments
   [[ -n ${args['--instance-type']:-} ]] || args['--instance-type']="rhodecode"
 
 }
 
 # :command.parse_requirements
 rcstack_cli_configure_vcsserver_parse_requirements() {
   # :command.fixed_flags_filter
   while [[ $# -gt 0 ]]; do
     case "${1:-}" in
       --help | -h)
         long_usage=yes
         rcstack_cli_configure_vcsserver_usage
         exit
         ;;
 
       *)
         break
         ;;
 
     esac
   done
 
   # :command.command_filter
   action="cli configure-vcsserver"
 
   # :command.parse_requirements_while
   while [[ $# -gt 0 ]]; do
     key="$1"
     case "$key" in
 
       -?*)
         printf "invalid option: %s\n" "$key" >&2
         exit 1
         ;;
 
       *)
         # :command.parse_requirements_case
         # :command.parse_requirements_case_simple
         if [[ -z ${args['ini_path']+x} ]]; then
           # :argument.validations
           if [[ -n $(validate_file_exists "$1") ]]; then
             printf "validation error in %s:\n%s\n" "INI_PATH" "$(validate_file_exists "$1")" >&2
             exit 1
           fi
 
           args['ini_path']=$1
           shift
         else
           printf "invalid argument: %s\n" "$key" >&2
           exit 1
         fi
 
         ;;
 
     esac
   done
 
   # :command.required_args_filter
   if [[ -z ${args['ini_path']+x} ]]; then
     printf "missing required argument: INI_PATH\nusage: rcstack cli configure-vcsserver INI_PATH\n" >&2
     exit 1
   fi
 
 }
 
 # :command.parse_requirements
 rcstack_cli_configure_rhodecode_parse_requirements() {
   # :command.fixed_flags_filter
   while [[ $# -gt 0 ]]; do
     case "${1:-}" in
       --help | -h)
         long_usage=yes
         rcstack_cli_configure_rhodecode_usage
         exit
         ;;
 
       *)
         break
         ;;
 
     esac
   done
 
   # :command.command_filter
   action="cli configure-rhodecode"
 
   # :command.parse_requirements_while
   while [[ $# -gt 0 ]]; do
     key="$1"
     case "$key" in
 
       -?*)
         printf "invalid option: %s\n" "$key" >&2
         exit 1
         ;;
 
       *)
         # :command.parse_requirements_case
         # :command.parse_requirements_case_simple
         if [[ -z ${args['ini_path']+x} ]]; then
           # :argument.validations
           if [[ -n $(validate_file_exists "$1") ]]; then
             printf "validation error in %s:\n%s\n" "INI_PATH" "$(validate_file_exists "$1")" >&2
             exit 1
           fi
 
           args['ini_path']=$1
           shift
         else
           printf "invalid argument: %s\n" "$key" >&2
           exit 1
         fi
 
         ;;
 
     esac
   done
 
   # :command.required_args_filter
   if [[ -z ${args['ini_path']+x} ]]; then
     printf "missing required argument: INI_PATH\nusage: rcstack cli configure-rhodecode INI_PATH\n" >&2
     exit 1
   fi
 
 }
 
 # :command.parse_requirements
 rcstack_backup_db_parse_requirements() {
   # :command.fixed_flags_filter
   while [[ $# -gt 0 ]]; do
     case "${1:-}" in
       --help | -h)
         long_usage=yes
         rcstack_backup_db_usage
         exit
         ;;
 
       *)
         break
         ;;
 
     esac
   done
 
   # :command.dependencies_filter
   if ! command -v tar >/dev/null 2>&1; then
     printf "missing dependency: tar\n" >&2
     exit 1
   fi
 
   if ! command -v gzip >/dev/null 2>&1; then
     printf "missing dependency: gzip\n" >&2
     exit 1
   fi
 
   # :command.command_filter
   action="backup-db"
 
   # :command.parse_requirements_while
   while [[ $# -gt 0 ]]; do
     key="$1"
     case "$key" in
 
       -?*)
         printf "invalid option: %s\n" "$key" >&2
         exit 1
         ;;
 
       *)
         # :command.parse_requirements_case
         # :command.parse_requirements_case_simple
         printf "invalid argument: %s\n" "$key" >&2
         exit 1
 
         ;;
 
     esac
   done
 
 }
 
 # :command.parse_requirements
 rcstack_backup_data_parse_requirements() {
   # :command.fixed_flags_filter
   while [[ $# -gt 0 ]]; do
     case "${1:-}" in
       --help | -h)
         long_usage=yes
         rcstack_backup_data_usage
         exit
         ;;
 
       *)
         break
         ;;
 
     esac
   done
 
   # :command.dependencies_filter
   if ! command -v tar >/dev/null 2>&1; then
     printf "missing dependency: tar\n" >&2
     exit 1
   fi
 
   if ! command -v gzip >/dev/null 2>&1; then
     printf "missing dependency: gzip\n" >&2
     exit 1
   fi
 
   # :command.command_filter
   action="backup-data"
 
   # :command.parse_requirements_while
   while [[ $# -gt 0 ]]; do
     key="$1"
     case "$key" in
 
       -?*)
         printf "invalid option: %s\n" "$key" >&2
         exit 1
         ;;
 
       *)
         # :command.parse_requirements_case
         # :command.parse_requirements_case_simple
         printf "invalid argument: %s\n" "$key" >&2
         exit 1
 
         ;;
 
     esac
   done
 
 }
 
 # :command.parse_requirements
 rcstack_get_build_artifacts_parse_requirements() {
   # :command.fixed_flags_filter
   while [[ $# -gt 0 ]]; do
     case "${1:-}" in
       --help | -h)
         long_usage=yes
         rcstack_get_build_artifacts_usage
         exit
         ;;
 
       *)
         break
         ;;
 
     esac
   done
 
   # :command.command_filter
   action="get-build-artifacts"
 
   # :command.parse_requirements_while
   while [[ $# -gt 0 ]]; do
     key="$1"
     case "$key" in
       # :flag.case
       --auth)
 
         # :flag.case_arg
         if [[ -n ${2+x} ]]; then
 
           args['--auth']="$2"
           shift
           shift
         else
           printf "%s\n" "--auth requires an argument: --auth AUTH" >&2
           exit 1
         fi
         ;;
 
       # :flag.case
       --installer-url)
 
         # :flag.case_arg
         if [[ -n ${2+x} ]]; then
 
           args['--installer-url']="$2"
           shift
           shift
         else
           printf "%s\n" "--installer-url requires an argument: --installer-url INSTALLER_URL" >&2
           exit 1
         fi
         ;;
 
       # :flag.case
       --manifest-url)
 
         # :flag.case_arg
         if [[ -n ${2+x} ]]; then
 
           args['--manifest-url']="$2"
           shift
           shift
         else
           printf "%s\n" "--manifest-url requires an argument: --manifest-url MANIFEST_URL" >&2
           exit 1
         fi
         ;;
 
       # :flag.case
       --version-name)
 
         # :flag.case_arg
         if [[ -n ${2+x} ]]; then
 
           args['--version-name']="$2"
           shift
           shift
         else
           printf "%s\n" "--version-name requires an argument: --version-name VERSION_NAME" >&2
           exit 1
         fi
         ;;
 
       -?*)
         printf "invalid option: %s\n" "$key" >&2
         exit 1
         ;;
 
       *)
         # :command.parse_requirements_case
         # :command.parse_requirements_case_simple
         printf "invalid argument: %s\n" "$key" >&2
         exit 1
 
         ;;
 
     esac
   done
 
   # :command.default_assignments
   [[ -n ${args['--auth']:-} ]] || args['--auth']=""
   [[ -n ${args['--installer-url']:-} ]] || args['--installer-url']="https://dls.rhodecode.com/dls/N2E2ZTY1NzA3NjYxNDA2NTc1NjI3MTcyNzA2MjcxNzIyZTcwNjI3YQ==/rhodecode-control/latest-linux-ee"
   [[ -n ${args['--manifest-url']:-} ]] || args['--manifest-url']="https://dls.rhodecode.com/linux/MANIFEST"
   [[ -n ${args['--version-name']:-} ]] || args['--version-name']="$RC_CLI_VERSION_NAME"
 
 }
 
 # :command.parse_requirements
 rcstack_build_installer_parse_requirements() {
   # :command.fixed_flags_filter
   while [[ $# -gt 0 ]]; do
     case "${1:-}" in
       --help | -h)
         long_usage=yes
         rcstack_build_installer_usage
         exit
         ;;
 
       *)
         break
         ;;
 
     esac
   done
 
   # :command.command_filter
   action="build-installer"
 
   # :command.parse_requirements_while
   while [[ $# -gt 0 ]]; do
     key="$1"
     case "$key" in
       # :flag.case
       --version-name)
 
         # :flag.case_arg
         if [[ -n ${2+x} ]]; then
 
           args['--version-name']="$2"
           shift
           shift
         else
           printf "%s\n" "--version-name requires an argument: --version-name VERSION_NAME" >&2
           exit 1
         fi
         ;;
 
       -?*)
         printf "invalid option: %s\n" "$key" >&2
         exit 1
         ;;
 
       *)
         # :command.parse_requirements_case
         # :command.parse_requirements_case_simple
         printf "invalid argument: %s\n" "$key" >&2
         exit 1
 
         ;;
 
     esac
   done
 
   # :command.default_assignments
   [[ -n ${args['--version-name']:-} ]] || args['--version-name']="$RC_CLI_VERSION_NAME"
 
 }
 
 # :command.parse_requirements
 rcstack_get_build_source_parse_requirements() {
   # :command.fixed_flags_filter
   while [[ $# -gt 0 ]]; do
     case "${1:-}" in
       --help | -h)
         long_usage=yes
         rcstack_get_build_source_usage
         exit
         ;;
 
       *)
         break
         ;;
 
     esac
   done
 
   # :command.dependencies_filter
   if ! command -v curl >/dev/null 2>&1; then
     printf "missing dependency: curl\n" >&2
     exit 1
   fi
 
   if ! command -v tar >/dev/null 2>&1; then
     printf "missing dependency: tar\n" >&2
     exit 1
   fi
 
   # :command.command_filter
   action="get-build-source"
 
   # :command.parse_requirements_while
   while [[ $# -gt 0 ]]; do
     key="$1"
     case "$key" in
       # :flag.case
       --revision)
 
         # :flag.case_arg
         if [[ -n ${2+x} ]]; then
 
           args['--revision']="$2"
           shift
           shift
         else
           printf "%s\n" "--revision requires an argument: --revision REVISION" >&2
           exit 1
         fi
         ;;
 
       # :flag.case
       --auth-token)
 
         # :flag.case_arg
         if [[ -n ${2+x} ]]; then
 
           args['--auth-token']="$2"
           shift
           shift
         else
           printf "%s\n" "--auth-token requires an argument: --auth-token AUTH_TOKEN" >&2
           exit 1
         fi
         ;;
 
       # :flag.case
       --server-url)
 
         # :flag.case_arg
         if [[ -n ${2+x} ]]; then
 
           args['--server-url']="$2"
           shift
           shift
         else
           printf "%s\n" "--server-url requires an argument: --server-url SERVER_URL" >&2
           exit 1
         fi
         ;;
 
       -?*)
         printf "invalid option: %s\n" "$key" >&2
         exit 1
         ;;
 
       *)
         # :command.parse_requirements_case
         # :command.parse_requirements_case_simple
         printf "invalid argument: %s\n" "$key" >&2
         exit 1
 
         ;;
 
     esac
   done
 
   # :command.default_assignments
   [[ -n ${args['--revision']:-} ]] || args['--revision']="default"
   [[ -n ${args['--server-url']:-} ]] || args['--server-url']="https://code.rhodecode.com"
 
 }
 
 # :command.parse_requirements
 rcstack_build_source_parse_requirements() {
   # :command.fixed_flags_filter
   while [[ $# -gt 0 ]]; do
     case "${1:-}" in
       --help | -h)
         long_usage=yes
         rcstack_build_source_usage
         exit
         ;;
 
       *)
         break
         ;;
 
     esac
   done
 
   # :command.command_filter
   action="build-source"
 
   # :command.parse_requirements_while
   while [[ $# -gt 0 ]]; do
     key="$1"
     case "$key" in
       # :flag.case
       --version-name)
 
         # :flag.case_arg
         if [[ -n ${2+x} ]]; then
 
           args['--version-name']="$2"
           shift
           shift
         else
           printf "%s\n" "--version-name requires an argument: --version-name VERSION_NAME" >&2
           exit 1
         fi
         ;;
 
       # :flag.case
       --tag)
 
         # :flag.case_arg
         if [[ -n ${2+x} ]]; then
 
           if [[ -z ${args['--tag']+x} ]]; then
             args['--tag']="\"$2\""
           else
             args['--tag']="${args[--tag]} \"$2\""
           fi
           shift
           shift
         else
           printf "%s\n" "--tag requires an argument: --tag TAG" >&2
           exit 1
         fi
         ;;
 
       -?*)
         printf "invalid option: %s\n" "$key" >&2
         exit 1
         ;;
 
       *)
         # :command.parse_requirements_case
         # :command.parse_requirements_case_simple
         printf "invalid argument: %s\n" "$key" >&2
         exit 1
 
         ;;
 
     esac
   done
 
   # :command.default_assignments
   [[ -n ${args['--version-name']:-} ]] || args['--version-name']="$RC_CLI_VERSION_NAME"
 
 }
 
 # :command.parse_requirements
 rcstack__completions_parse_requirements() {
   # :command.fixed_flags_filter
   while [[ $# -gt 0 ]]; do
     case "${1:-}" in
       --help | -h)
         long_usage=yes
         rcstack__completions_usage
         exit
         ;;
 
       *)
         break
         ;;
 
     esac
   done
 
   # :command.command_filter
   action="_completions"
 
   # :command.parse_requirements_while
   while [[ $# -gt 0 ]]; do
     key="$1"
     case "$key" in
 
       -?*)
         printf "invalid option: %s\n" "$key" >&2
         exit 1
         ;;
 
       *)
         # :command.parse_requirements_case
         # :command.parse_requirements_case_simple
         printf "invalid argument: %s\n" "$key" >&2
         exit 1
 
         ;;
 
     esac
   done
 
 }
 
 # :command.initialize
 initialize() {
   version="4.28.0.REL.2023.40"
   long_usage=''
   set -e
 
   # :command.environment_variables_default
   export RCC_CONFIG="${RCC_CONFIG:-.rcstack.ini}"
   export RC_STACK_ROUTER_EXT="${RC_STACK_ROUTER_EXT:-.custom/docker-compose-router.override.yaml}"
   export RC_STACK_METRICS_EXT="${RC_STACK_METRICS_EXT:-.custom/docker-compose-metrics.override.yaml}"
   export RC_STACK_SERVICES_EXT="${RC_STACK_SERVICES_EXT:-.custom/docker-compose-services.override.yaml}"
   export RC_STACK_RHODECODE_EXT="${RC_STACK_RHODECODE_EXT:-.custom/docker-compose-apps.override.yaml}"
 
   # src/initialize.sh
   rc_image_ver=4.28.0.REL.2023.01.23.2
 
   RC_STACK_ROUTER_VER=v1
   RC_STACK_SERVICES_VER=v1
   RC_STACK_RHODECODE_VER=v1
   RC_STACK_METRICS_VER=v1
 
   RC_SCRIPT_NAME=rcstack
   # bootstrap file is a config file at the same time
   CONFIG_FILE=${RCC_CONFIG:=.rcstack.ini}
 
   # runtime env file
   RUNTIME_ENV=$PWD/.custom/.runtime.env
 
   # STACK_LIST
   VALID_SERVICES="router metrics services rhodecode"
   DOCKER_DEFS_WORK_DIR="docker_defs"
 
   # stage key, saved in .rcstack.ini : stage func to execute
   BOOTSTRAP_STAGES="\
   bootstrap_v1_docker_install:bootstrap_docker_install \
   bootstrap_v1_docker_commons:bootstrap_docker_commons \
   bootstrap_v1_definitions:bootstrap_definitions \
   bootstrap_v1_config:bootstrap_config \
   bootstrap_v1_overrides:bootstrap_overrides \
   "
 
   #echo "1 ----"
   #echo $RC_STACK_SERVICES_EXT
   #echo $RC_STACK_METRICS_EXT
   #echo "1 -----"
 
   #echo '2 ----'
   #grep -v -e '^#' "$ENV_FILE" | xargs -I {} echo \'{}\'
   #echo '2 ----'
 
   #expose env vars from ./rcstack config
   #if [[ -f $ENV_FILE ]]; then
   #  eval $(grep -v -e '^#' "$ENV_FILE" | xargs -I {} echo export \'{}\')
   #fi
 
   #ENV_EXPAND=""
   #for k in $(config_keys); do
   #  k_upper=${k^^}
   #  env_entry="-e $k_upper='$(config_get "$k")' "
   #  ENV_EXPAND+=$env_entry;
   #  #echo $env_expand
   #done
 
   #
   #echo "3 ----"
   #echo $RC_STACK_SERVICES_EXT
   #echo $RC_STACK_METRICS_EXT
   #echo $RC_STACK_RHODECODE_EXT
   #echo "3 -----"
 
   #env | grep RC_
 
   docker_ping_host() {
     PING_HOST="$1"
     docker run --network rhodecode_network --rm alpine ping "$PING_HOST"
   }
 
   get_started() {
     echo ""
     echo "To start using RhodeCode run the following stacks using './$RC_SCRIPT_NAME stack [STACK_NAME]'"
     echo "Check './$RC_SCRIPT_NAME stack --help' for more examples and options"
     echo "$(green_bold IMPORTANT): init command generates some secrets/config inside $RUNTIME_ENV file."
     echo "Check and adjust those settings if needed"
     echo ""
     echo "$(green_bold 1\) router [Mandatory]): run the edge router to control stack traffic / domain access and optionally SSL termination"
     echo "IMPORTANT: router binds to some common ports 80, 443, SSH (9022), Loki (3100) if those are not available, please adjust them"
     echo "To configure this stack before running check: $RC_STACK_ROUTER_EXT"
 
     echo "./$RC_SCRIPT_NAME stack router up --detach"
     echo ""
     echo "$(green_bold 2\) services [Mandatory]): run the services, like database, redis, channelstream etc..."
     echo "IMPORTANT: if you like to run your own database, or redis please adjust before running"
     echo "To configure this stack before running check: $RC_STACK_SERVICES_EXT"
     echo "./$RC_SCRIPT_NAME stack services up --detach"
     echo ""
     echo "$(green_bold 3\) rhodecode [Mandatory]): run the rhodecode app stack"
     echo "To configure this stack before running check: $RC_STACK_RHODECODE_EXT"
     echo "./$RC_SCRIPT_NAME stack rhodecode up --detach"
     echo ""
     echo "$(yellow_bold 4\) metrics [Optional]): run the monitoring stack, this includes grafana/prometheus logging/metrics system"
     echo "To configure this stack before running check: $RC_STACK_METRICS_EXT"
     echo "./$RC_SCRIPT_NAME stack metrics up --detach"
     echo ""
     echo "$(bold [Status]): check services run status, ports etc.."
     echo "./$RC_SCRIPT_NAME status"
     echo ""
     echo "$(bold [Logs]): check service logs"
     echo "./$RC_SCRIPT_NAME stack [STACK_NAME] logs"
   }
 
   get_started_full() {
     echo "$(blue_bold [~~~~ GET STARTED ~~~~~])"
     echo "./$RC_SCRIPT_NAME is a CLI based installer/manager for RhodeCode Cluster Stack"
     echo "./$RC_SCRIPT_NAME -h is your friend, in case of doubt, check examples and usage options with -h / --help flag"
     echo ""
     echo "$(yellow_bold [First time run])"
     echo "run './$RC_SCRIPT_NAME init' to setup docker and download required installer files."
     echo "./$RC_SCRIPT_NAME can install Docker for you, or install it manually before running init command"
 
     get_started
   }
 
 }
 
 # :command.run
 run() {
   declare -A args=()
   declare -a other_args=()
   declare -a input=()
   normalize_input "$@"
   parse_requirements "${input[@]}"
 
   case "$action" in
     "get-started")
       if [[ ${args['--help']:-} ]]; then
         long_usage=yes
         rcstack_get_started_usage
       else
         rcstack_get_started_command
       fi
       ;;
 
     "init")
       if [[ ${args['--help']:-} ]]; then
         long_usage=yes
         rcstack_init_usage
       else
         rcstack_init_command
       fi
       ;;
 
     "self-update")
       if [[ ${args['--help']:-} ]]; then
         long_usage=yes
         rcstack_self_update_usage
       else
         rcstack_self_update_command
       fi
       ;;
 
     "stack")
       if [[ ${args['--help']:-} ]]; then
         long_usage=yes
         rcstack_stack_usage
       else
         rcstack_stack_command
       fi
       ;;
 
     "stack router")
       if [[ ${args['--help']:-} ]]; then
         long_usage=yes
         rcstack_stack_router_usage
       else
         rcstack_stack_router_command
       fi
       ;;
 
     "stack metrics")
       if [[ ${args['--help']:-} ]]; then
         long_usage=yes
         rcstack_stack_metrics_usage
       else
         rcstack_stack_metrics_command
       fi
       ;;
 
     "stack services")
       if [[ ${args['--help']:-} ]]; then
         long_usage=yes
         rcstack_stack_services_usage
       else
         rcstack_stack_services_command
       fi
       ;;
 
     "stack rhodecode")
       if [[ ${args['--help']:-} ]]; then
         long_usage=yes
         rcstack_stack_rhodecode_usage
       else
         rcstack_stack_rhodecode_command
       fi
       ;;
 
     "stack all")
       if [[ ${args['--help']:-} ]]; then
         long_usage=yes
         rcstack_stack_all_usage
       else
         rcstack_stack_all_command
       fi
       ;;
 
     "stack-status")
       if [[ ${args['--help']:-} ]]; then
         long_usage=yes
         rcstack_stack_status_usage
       else
         rcstack_stack_status_command
       fi
       ;;
 
     "stack-upgrade")
       if [[ ${args['--help']:-} ]]; then
         long_usage=yes
         rcstack_stack_upgrade_usage
       else
         rcstack_stack_upgrade_command
       fi
       ;;
 
     "stack-upgrade router")
       if [[ ${args['--help']:-} ]]; then
         long_usage=yes
         rcstack_stack_upgrade_router_usage
       else
         rcstack_stack_upgrade_router_command
       fi
       ;;
 
     "stack-upgrade metrics")
       if [[ ${args['--help']:-} ]]; then
         long_usage=yes
         rcstack_stack_upgrade_metrics_usage
       else
         rcstack_stack_upgrade_metrics_command
       fi
       ;;
 
     "stack-upgrade services")
       if [[ ${args['--help']:-} ]]; then
         long_usage=yes
         rcstack_stack_upgrade_services_usage
       else
         rcstack_stack_upgrade_services_command
       fi
       ;;
 
     "stack-upgrade rhodecode")
       if [[ ${args['--help']:-} ]]; then
         long_usage=yes
         rcstack_stack_upgrade_rhodecode_usage
       else
         rcstack_stack_upgrade_rhodecode_command
       fi
       ;;
 
     "cli")
       if [[ ${args['--help']:-} ]]; then
         long_usage=yes
         rcstack_cli_usage
       else
         rcstack_cli_command
       fi
       ;;
 
     "cli image-info")
       if [[ ${args['--help']:-} ]]; then
         long_usage=yes
         rcstack_cli_image_info_usage
       else
         rcstack_cli_image_info_command
       fi
       ;;
 
     "cli redis")
       if [[ ${args['--help']:-} ]]; then
         long_usage=yes
         rcstack_cli_redis_usage
       else
         rcstack_cli_redis_command
       fi
       ;;
 
     "cli db")
       if [[ ${args['--help']:-} ]]; then
         long_usage=yes
         rcstack_cli_db_usage
       else
         rcstack_cli_db_command
       fi
       ;;
 
     "cli db-upgrade")
       if [[ ${args['--help']:-} ]]; then
         long_usage=yes
         rcstack_cli_db_upgrade_usage
       else
         rcstack_cli_db_upgrade_command
       fi
       ;;
 
     "cli storage")
       if [[ ${args['--help']:-} ]]; then
         long_usage=yes
         rcstack_cli_storage_usage
       else
         rcstack_cli_storage_command
       fi
       ;;
 
     "cli attach")
       if [[ ${args['--help']:-} ]]; then
         long_usage=yes
         rcstack_cli_attach_usage
       else
         rcstack_cli_attach_command
       fi
       ;;
 
     "cli configure-vcsserver")
       if [[ ${args['--help']:-} ]]; then
         long_usage=yes
         rcstack_cli_configure_vcsserver_usage
       else
         rcstack_cli_configure_vcsserver_command
       fi
       ;;
 
     "cli configure-rhodecode")
       if [[ ${args['--help']:-} ]]; then
         long_usage=yes
         rcstack_cli_configure_rhodecode_usage
       else
         rcstack_cli_configure_rhodecode_command
       fi
       ;;
 
     "backup-db")
       if [[ ${args['--help']:-} ]]; then
         long_usage=yes
         rcstack_backup_db_usage
       else
         rcstack_backup_db_command
       fi
       ;;
 
     "backup-data")
       if [[ ${args['--help']:-} ]]; then
         long_usage=yes
         rcstack_backup_data_usage
       else
         rcstack_backup_data_command
       fi
       ;;
 
     "get-build-artifacts")
       if [[ ${args['--help']:-} ]]; then
         long_usage=yes
         rcstack_get_build_artifacts_usage
       else
         rcstack_get_build_artifacts_command
       fi
       ;;
 
     "build-installer")
       if [[ ${args['--help']:-} ]]; then
         long_usage=yes
         rcstack_build_installer_usage
       else
         rcstack_build_installer_command
       fi
       ;;
 
     "get-build-source")
       if [[ ${args['--help']:-} ]]; then
         long_usage=yes
         rcstack_get_build_source_usage
       else
         rcstack_get_build_source_command
       fi
       ;;
 
     "build-source")
       if [[ ${args['--help']:-} ]]; then
         long_usage=yes
         rcstack_build_source_usage
       else
         rcstack_build_source_command
       fi
       ;;
 
     "_completions")
       if [[ ${args['--help']:-} ]]; then
         long_usage=yes
         rcstack__completions_usage
       else
         rcstack__completions_command
       fi
       ;;
 
   esac
 }
 
 initialize
 run "$@"