JSON Configs
A JSON config stores a JSON configuration file in the Bahriya platform. The content is validated on upload, versioned, and delivered to your containers as a mounted file.
A JSON config stores a JSON configuration file in the Bahriya platform. The content is validated on upload, versioned, and delivered to your containers as a mounted file.
When to use a JSON config
- Your application reads configuration from a JSON file at startup (for example
config.jsonorappsettings.json) - You want to change configuration without rebuilding your container image
- You need the same configuration file available across multiple containers or regions
- You want to version configuration changes and roll back if needed
What Bahriya stores
When you upload a JSON config, Bahriya validates that the content is syntactically correct JSON and stores it alongside metadata:
| Field | Description |
|---|---|
| Name | A human-readable display name |
| Handle | A DNS-1123-compliant identifier (immutable after creation) |
| Content | The full JSON content (shown back in the console and API) |
Unlike vault items, JSON config content is shown back in the console, API responses, and CLI output.
Mounting in containers
When you attach a JSON config to a container, you choose a mount path. The config file appears as:
<mount-path>/config.jsonYour application reads it from this path. For example, a Node.js service might reference /etc/config/app/config.json.
Rotation
Rotation creates a new version of the config. The previous version is retained for rollback. After rotation:
- File-mounted containers pick up the new config automatically within about 60 seconds. No manual action needed.
- If you need to force a restart, use the Redeploy button on the Consumers panel.
Pricing
JSON configs are billed at $0.01 per month while they exist, plus $0.05 per region per month when attached to a project.