Deployments

Environment Variables

Plain and secret variables, and the values VPSPilot sets for you.

Each application has up to 100 environment variables. They are encrypted at rest and written to a private file for the container on each deploy, so changes take effect on the next deployment.

Plain and secret variables

	Plain	Secret
Shown in the dashboard	Yes	Never again after saving
Available while building	Yes, as a build argument	No
Available at runtime	Yes	Yes
Encrypted at rest	Yes	Yes

Keys must start with a letter or underscore and contain only letters, digits and underscores. When you edit the list, send a secret without a value to keep its stored value unchanged.

Variables VPSPilot sets

Variable	Value
`PORT`	The port to listen on: the container port for Docker apps, the public port for systemd apps. Reserved: you can't set it yourself.
`VPSPILOT_SHARED_DIR`	systemd apps: a folder that survives releases, for uploads and other files.
`HOST / HOSTNAME`	systemd apps: `0.0.0.0`, so frameworks that read them bind to every interface.
`DATABASE_URL`	Added when you attach a database (the name is configurable). See Users and Attaching.

Updating through the API

http

PATCH /api/v1/applications/{app_id}{  "env": [    { "key": "NODE_ENV", "value": "production" },    { "key": "STRIPE_SECRET_KEY", "value": "sk_live_...", "secret": true },    { "key": "SESSION_SECRET", "secret": true }  ]}

The list replaces the whole environment. SESSION_SECRET above has no value, so its stored value is kept.