A.2. Environment Variables

Tungsten Dashboard uses environment variables for some of its configuration. Environment variables are used for the Docker Compose method of installation and development mode.

Environment variables are stored in the .env file.

Along with the values below, all variables available within the values.yaml can be included by converting them to UPPERCASE and prefixing them with DASHBOARD_ - for example to set the keystore properties in values.yaml you would define keystorePath where the equivalent environment variable would then be DASHBOARD_KEYSTORE_PATH. See Section A.3, “The values.yaml file” for a full list.

Table A.1. Environment Variables

OptionDescription
DASHBOARD_ENVEnvironment definition (e.g. for different config files selection)
DASHBOARD_SECRET32 bytes long string that will be used to encrypt cluster credentials

An example can be seen below:

DASHBOARD_ENV=production
DASHBOARD_BASE_URL=example.com
DASHBOARD_PORT=4090
DASHBOARD_PATH=
DASHBOARD_SSL=false
DASHBOARD_SECRET=e5I0vP+MFThNPBLbCcwf4xXrAWdf3mzK
DASHBOARD_DEFAULT_USER=admin
DASHBOARD_DEFAULT_USER_PASSWORD=admin

Warning

It is critical that the DASHBOARD_SECRET key is stored safely as it will be required for future upgrades since it serves as the encryption key. If it is lost, then there is the possibility of losing data after upgrades.