Variables

Variables provide a way to configure your services and share secrets across a project. They are injected into your containers as environment variables at build and runtime.

Service variables

Variables scoped to an individual service are set from the service panel.

1. Click the service node to open the service panel.
2. Go to the Variables tab.
3. Click New Variable, enter a name and value, and press Add.

Raw editor

For bulk imports, click Raw Editor to paste the contents of a .env file directly. Key-value pairs are parsed and added to the service automatically.

Editing and deleting variables

Hover over a variable row to reveal the edit (pencil) and delete (trash) icons. Click the pencil to update the value inline, or click the trash icon to remove the variable.

Shared variables

Shared variables reduce duplication when multiple services need the same value (e.g. an API key or a base URL).

Shared variables are managed from Project Settings → Shared Variables.

1. Choose the environment.
2. Enter the variable name and value, then click Add.
3. To make a shared variable available to a service, click Share next to the variable and select the target services.

Alternatively, from the service's Variables tab, click Shared Variable to browse and import shared variables into the service as reference variables.

Reference variables

Reference variables let you compose values from other variables — including variables in other services, shared variables, and platform-provided variables.

Simplifyd Cloud uses a ${{...}} template syntax for references.

Reference a variable in the same service

AUTH_ENDPOINT=https://${{BASE_URL}}/${{AUTH_PATH}}

Reference a shared variable

API_KEY=${{shared.API_KEY}}

Reference another service's variable

Use the service name followed by the variable name:

DATABASE_URL=${{postgres.DATABASE_URL}}

Where postgres is the name of another service in the same environment.

Autocomplete

The variable value input field provides an autocomplete dropdown as you type ${{. Begin typing a service name or variable name to narrow the results.

Simplifyd-provided variables

Simplifyd Cloud automatically injects the following variables into every service deployment:

These variables can be used in reference expressions:

API_URL=https://${{backend.SIMPLIFYD_PUBLIC_DOMAIN}}

Multiline variables

Variable values can span multiple lines. In the variable input field, press Ctrl + Enter (Cmd + Enter on Mac) to insert a newline, or use the Raw Editor to paste a multi-line value directly.