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.

Updated 23 Jun 20262 min read

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.json or appsettings.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:

FieldDescription
NameA human-readable display name
HandleA DNS-1123-compliant identifier (immutable after creation)
ContentThe 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.json

Your 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.

See also