Variables

Environment configuration allows a Release Manager or Stack Manager to set non-sensitive environment configuration variables through SilverStripe Platform. These are currently restricted to constants (key/value) that will be placed in the environment file.

This file will also contain variables that are provided by the SilverStripe platform so that the application can connect to databases and other services. These system provided variables will not show up in the variables section. It is not possible to set or override these constants. Here is an example of pre-defined variables:

  • SS_DATABASE_SERVER
  • SS_DATABASE_USERNAME
  • SS_DATABASE_PASSWORD
  • SS_DATABASE_NAME
  • SS_DATABASE_TIMEZONE
  • SS_TRUSTED_PROXY_IPS
  • SS_USE_SSL
  • AWS_REGION_NAME
  • AWS_SYSLOG_*
  • AWS_DYNAMODB_*
  • ELASTICSEARCH_HOST (only if stack has elasticsearch)
  • ELASTICSEARCH_PORT (only if stack has elasticsearch)
  • ELASTICSEARCH_INDEX (only if stack has elasticsearch)

You can access the environment configuration by navigating to the environment and selecting the configuration tab.

SilverStripe Platform Dashboard

Updating environment configuration

Environment configuration is a key/value store which translates into entries in your environment file.

To add, update or remove a variable simply click the edit button in the top right, type in the variable and its value and then press ‘Save’.

SilverStripe Platform Dashboard

You can remove an existing variable by clicking the remove button on the chosen row.

Deploying changes

To deploy environment changes, a full deployment is necessary which takes approximately 15-20 minutes, depending on your project and environment.

SilverStripe Platform Dashboard

The actual values of the variables will never be disclosed outside of the “Configuration” section of the Dashboard.