Variables & Secrets

You can define Variables and Secrets inside your service to pass information to your container at runtime as environment variables. Additionally, you can also mount them into your container's filesystem to let your application read it at runtime.

As an example for a service running an nginx container, you can define nginx configuration as a variable and mount it into /etc/nginx/sites-available/default path to easily setup a custom reverse proxy in your environment. This allows you to use any image and configure it via files.

To view all variables and secrets of a service:

• Open the service details,
• Use Variables & Secrets link located inside menulist on the left.

Security

Values of secrets are encrypted at rest to prevent leaking sensitive values even our system gets compromised.

Managing Variables & Secrets

You can create new variable and secret, update them or delete them.

Creating

While viewing the variables and secrets you can use Add button under corresponding section to create whether a variable or a secret. When you use the button, a new entry will be added to the bottom for you to provide necessary information:

1. Key: Key of the environment variable. It must contain only alphanumeric characters [a-zA-Z0-9] or an underscore _ character. Maximum length of a key is 128 character.
2. Value: Value of the environment variable. Maximum length of a value is 8192 character.

After specifying them, you can use button with Plus icon to finish adding it.

Updating

Simply modify the key or value of a variable or secret. When you finish modifying a variable or secret, use button with Save icon to update it.

Deleting

Simply use the button with Trash icon positioned next to the variable to delete it. It will require a confirmation from you.

⚠️ Please be careful

If the deleted variable or secret was mounted inside the container, it will be unmounted.