Environment Commands

env

List environment variables for an application.

$ convox cloud env -a <app> -i <machine>

Options:

  • --release: Specific release
  • --watch: Watch for updates

Example:

$ convox cloud env -a myapp -i production
DATABASE_URL=postgres://localhost/myapp
NODE_ENV=production

env edit

Edit environment variables interactively.

$ convox cloud env edit -a <app> -i <machine>

Options:

  • --promote: Auto-promote after editing

env get

Get a specific environment variable.

$ convox cloud env get <var> -a <app> -i <machine>

Example:

$ convox cloud env get DATABASE_URL -a myapp -i production
postgres://localhost/myapp

env set

Set environment variables.

$ convox cloud env set <key=value> [key=value]... -a <app> -i <machine>

Options:

  • --promote: Auto-promote after setting
  • --replace: Replace all environment variables

Example:

$ convox cloud env set NODE_ENV=production API_KEY=secret -a myapp -i production
Setting NODE_ENV, API_KEY... OK
Release: RCDEFGHIJK

env unset

Remove environment variables.

$ convox cloud env unset <key> [key]... -a <app> -i <machine>

Options:

  • --promote: Auto-promote after unsetting

Example:

$ convox cloud env unset DEBUG_MODE -a myapp -i production
Unsetting DEBUG_MODE... OK
Release: RDEFGHIJKL