Environments
An environment represents a stage in the deployment process — e.g. DEV, TEST, QA, or PROD. Environments are freely configurable.
Creating an Environment
Section titled “Creating an Environment”- Navigate to Environments in the sidebar
- Click New Environment
- Fill in the fields:
| Field | Description |
|---|---|
| Name | Technical name (e.g. prod) — must be unique |
| Display Name | Display name (e.g. “Production”) |
| Color | Hex color code for visual distinction (e.g. #22C55E) |
| Sort Order | Display order in the UI |
Base Config vs. Environment Override
Section titled “Base Config vs. Environment Override”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).
Environment Switcher
Section titled “Environment Switcher”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.
Default Environment
Section titled “Default Environment”An environment can be marked as default. The default environment is automatically pre-selected in the switcher.
Environment Permissions
Section titled “Environment Permissions”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.