Skip to content

Environments

An environment represents a stage in the deployment process — e.g. DEV, TEST, QA, or PROD. Environments are freely configurable.

  1. Navigate to Environments in the sidebar
  2. Click New Environment
  3. Fill in the fields:
FieldDescription
NameTechnical name (e.g. prod) — must be unique
Display NameDisplay name (e.g. “Production”)
ColorHex color code for visual distinction (e.g. #22C55E)
Sort OrderDisplay order in the UI

Presswerk uses a two-level configuration model:

Base Config (Data Source default configuration)
▼ + Environment Override (optional)
Effective Configuration
  • Base Config — The default configuration of a data source. Used when no environment is selected or no override exists.
  • Environment Override — Per environment, you can configure different connection parameters. Only explicitly set fields override the base.

Overrides are configured in the data source detail view under the Environments tab (see Data Sources).

At the bottom of the sidebar you’ll find the Environment Switcher. The first option is always “Base Config” (= default connection). The configured environments follow after.

The switcher determines which data source the application works against:

  • Base Config → Data sources use their default connections
  • TEST → Data sources use the TEST override (if available, otherwise base config)

The switcher affects the report designer, data set test execution, and PDF export.

An environment can be marked as default. The default environment is automatically pre-selected in the switcher.

Via environment permissions, you control which users or groups can deploy to which environments. Only users with the corresponding permission see the environment in the deploy drawer.