```{title} Standalone Remote Database
```

# 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.

```{parsed-literal}
cd /tmp
curl -O {{ release_url }}
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.

```bash
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 `""`.
```