Standalone Remote Database

Admins may wish to use a Managed Database Service such as RDS and Elasticache or have a separate PostgreSQL Database and Redis server from their Kasm installation.

This guide provides instructions on how to initialize the database server from a remote machine and then install the Kasm WebApp.

Requirements

  • Remote PostgreSQL server supports PostgreSQL version 12.

  • Remote PostgreSQL either already has a User “kasmapp” in the database “kasm” OR you have SuperUser credentials on the database.

  • Remote Redis server supports Redis version 5.

  • Machine executing initialization and the Web App server can both connect to the PostgreSQL Database (default port TCP/5432)

  • Web App servers can connect to Redis Server (default port TCP/6379)

Initializing PostgreSQL Server

  • Download latest version of Kasm Workspaces to /tmp

  • Extract package and initialize the Database.

cd /tmp
curl -O https://kasm-static-content.s3.amazonaws.com/kasm_release_1.11.0.18142e.tar.gz
tar -xf kasm_release*.tar.gz
sudo bash kasm_release/install.sh -e -S init_remote_db -q [DATABASE_HOSTNAME] -Q [DATABASE_KASMAPP_USER_PASSWORD] -g [DATABASE_SUPERUSER_USERNAME] -G [DATABASE_SUPERUSER_PASSWORD]

Note

If the Database already has the User “kasmapp” and database “kasm” created you may omit the -g and -G parameters.

Installing Kasm Web App

  • Download latest version of Kasm Workspaces to /tmp

  • Extract package and initialize the Database.

cd /tmp
tar -xf kasm_release*.tar.gz
sudo bash kasm_release/install.sh -S app -q [DATABASE_HOSTNAME] -Q [DATABASE_KASMAPP_USER_PASSWORD] -o [REDIS_HOSTNAME] -R [REDIS_PASSWORD]

Note

If you are using Redis on Elasticache you will need to set [REDIS_PASSWORD] to "".