Configuration Bundles
Configuration bundles are reusable collections of environment variables and mounted files that can be attached to one or more stacks. They let you manage shared configuration — such as cloud credentials, database connection strings, or feature flags — in a single place and apply it consistently across stacks.
Overview
Each bundle contains:
- Environment Variables — key-value pairs injected into the run environment. Variables can be marked as secret to hide their values.
- Mounted Files — files placed at specified paths in the run workspace.
Bundles are scoped to a space and can be attached to any stack within that space.
Bundle list
The Bundles page displays all bundles with:
| Column | Description |
|---|---|
| Name | Bundle display name |
| Description | Optional description of the bundle's purpose |
| Space | The space the bundle belongs to |
| Variables | Number of environment variables |
| Files | Number of mounted files |
| Attached | Number of stacks using this bundle |
| Created | When the bundle was created |
The list supports search and pagination.
Creating a bundle
Click Create Bundle on the Bundles page. Provide:
- Name — a descriptive name (e.g.,
production-aws-creds,database-credentials) - Description — optional description of what the bundle contains
- Space — the space to create the bundle in
After creation, add environment variables and mounted files from the bundle detail page.
Bundle detail
The bundle detail page shows:
Bundle Information
- Created — when the bundle was created
- Bundle ID — unique identifier
- Environment Variables — count of variables
- Mounted Files — count of files
- Last Modified — when the bundle was last updated
Environment Variables tab
A table of all variables in the bundle:
| Column | Description |
|---|---|
| Key | Variable name (e.g., DB_HOST, AWS_REGION) |
| Value | The variable's value, or •••••••• if marked as secret |
| Secret | Whether the value is hidden |
| Description | Optional description of the variable's purpose |
Click Add Variable to add a new environment variable. Each variable can be edited or deleted individually.
Mounted Files tab
Files that will be placed at specified paths in the run workspace. Useful for configuration files, credential files, or other static content needed during execution.
Used by tab
Lists the stacks that have this bundle attached. This helps you understand the impact of changing a bundle's variables — any modification will affect all attached stacks.
Attaching bundles to stacks
Bundles are attached to stacks during the stack creation wizard (Step 3: Bundles) or by editing an existing stack's configuration.
When a run executes, Zenfra:
- Downloads the source bundle from Git
- Downloads attached configuration bundles
- Applies environment variables from bundles to the run environment
- Places mounted files in the workspace
This happens during the Preparing phase of a run.
Secret variables
Variables marked as secret have their values encrypted and hidden in the UI (shown as ••••••••). Secret values are:
- Never displayed in the dashboard after creation
- Injected securely into the run environment
- Not included in run logs