Managing Environment Variables

Set, view, and sync environment variables between your local development environment and CreateOS.

List Variables

createos env list

Values are shown in full by default. Use --hide to mask them:

createos env list --hide

Set Variables

# Set a single variable
createos env set DATABASE_URL=postgres://localhost:5432/mydb
 
# Set multiple at once
createos env set API_KEY=sk-xxx SECRET=my-secret NODE_ENV=production

Remove a Variable

createos env rm API_KEY

Sync with Local Files

Pull remote variables to a local .env file

createos env pull

This creates a .env.<environment-name> file (e.g., .env.production). The CLI auto-adds .env.* to your .gitignore.

Push local variables to remote

createos env push

The CLI reads your .env.<environment-name> file, shows what will change, and asks for confirmation. Use --force to skip confirmation in CI.

Specify a custom file

createos env pull --file .env.local
createos env push --file .env.staging

CI/CD Usage

# Set from CI secrets
createos env set DATABASE_URL=$DB_URL --project <id> --environment <id>
 
# Pull for local debugging
createos env pull --project <id> --environment <id> --force