Deploying

Variable groups

Keep a named set of variables once and give it to every app attached to it, from Settings → Variable groups and an app's Deploy tab.

Groups

A group has a name (lowercase letters, digits and dashes), variables (sealed with the master key, like an app's), and optionally a project. The list gives the variables' names and the apps that have the group; a group's values are shown only to those who may read an app's variables, so not to viewers.

API: GET/POST /api/env-groups, GET/PUT/DELETE /api/env-groups/{id}.

Attaching to apps

An app gets groups in order (its Deploy tab, or GET/PUT /api/apps/{id}/env-groups with the group ids). At each deploy (and build, for VITE_* variables) its variables are, each over the one before:

  1. its groups', in order: a later group's variable wins over an earlier one's;
  2. its own;
  3. its database links';

then ${{NAME}} references are filled in.

Like a change of the app's own variables, a change to a group (or to which groups an app has) reaches the app's containers at its next deploy; deleting a group takes its variables away at the next deploy too.

Projects

Someone limited to projects sees and edits only the groups in their projects, puts new ones in one of them, and attaches only those.