Skip to main content
App variables are values that you can store in the API to be used across all installs of an app template. App variables are meant for sensitive values that you want to manage through the API, but do not want included in the app as an input or secret. For example, an API key where you don’t want it visible in the app’s inputs TOML file as part of a git-backed repo. Nuon’s API stores app variables in the Nuon data plane which is a PostgreSQL database with no encryption.

​
Defining App Variables

You can create app variables using the CLI.
Once created you should be able to view the default using the CLI.
If you no longer need the default, you can delete it using the CLI

​
Using App Variables

App variables are included in the install state, and are available in job plans. Using our example secret named external_api_key, you could reference its value in your app config with the template expression {{ .nuon.app.variables.external_api_key }}.
If you add or update an app variable after an install has been created, you will need to update that install’s state before the value will be included in plans. Running a deploy or sandbox provision will trigger a state update.