Setting environment variables

This page explains how to configure environment variables in Shopware PaaS Native.

Please only use this to configure non-sensitive environment variables. For sensitive variables, please use secrets. There is a detailed guide here.

Configure environment variables

Environment variables are defined in the application.yaml file, in the following array app.environment_variables.

Environment variables need to be scoped, they can be configured either for RUN or BUILD

Scope	Description
RUN	The value is passed to Shopware application (runtime)
BUILD	Build-time environment variables

Once the application.yaml is updated as usual, run the following:

sw-paas application update

Configure an environment variable for runtime

Update the application.yaml file like this:

app:
  environment_variables:
    - name: MY_RUNTIME_VARIABLE
      value: my-value
      scope: RUN

Configure an environment variable for build-time

Update the application.yaml file like this:

app:
  environment_variables:
    - name: MY_BUILDTIME_VARIABLE
      value: my-value
      scope: BUILD

Complete example

Here is a full example of environment variables. They can be used for both build-time and runtime, and you can have multiple variables with the same name but different scopes.

app:
  # ... Other application settings
  environment_variables:
    - name: MY_BUILDTIME_VARIABLE
      value: bar
      scope: BUILD
    - name: MY_RUNTIME_VARIABLE
      value: foo
      scope: RUN
    - name: MY_VARIABLE_WITH_THE_SAME_NAME
      value: my-value
      scope: RUN
    - name: MY_VARIABLE_WITH_THE_SAME_NAME
      value: my-value
      scope: BUILD