Deploy JSON Configs with Reis (Flag Mode)

Deploy JSON configuration files to Bahriya with Reis flags: create from a file, rotate content, list versions, roll back, and attach to your projects.

Updated 31 Oct 20261 min read

Use the Reis CLI to manage JSON configuration files using command-line flags.

Create a JSON config

reis json_config:create \
  --org <organisation-id> \
  --name "App Settings" \
  --handle app-settings \
  --content_file ./config/app-settings.json

List JSON configs

reis json_config:list --org <organisation-id>

Shows a table with handle, name, and creation date for each config, plus its current version (for example v2 of 3) and when it was last rotated (Never until the first rotation).

Show a JSON config

reis json_config:show <config-id> --org <organisation-id>

Rotate (update content)

reis json_config:rotate <config-id> \
  --org <organisation-id> \
  --content_file ./config/app-settings-v2.json

List versions

reis json_config:versions <config-id> --org <organisation-id>

Activate a previous version

reis json_config:activate_version <config-id> <version-number> --org <organisation-id>

Delete a JSON config

reis json_config:delete <config-id> --org <organisation-id>

Add --force to skip the confirmation prompt.

Required flags for create

Flag	Description
`--name`	Human-readable display name
`--handle`	DNS-1123-compliant identifier (auto-generated from name if omitted)
`--content_file`	Path to a file containing valid JSON content

Attach to a project

reis project:attach <project-id> json_configs app-config

Singular alias json_config is also accepted. The project-id is the UUID Reis returns from project:list or project:show.

Detach from a project

reis project:detach <project-id> json_configs app-config

If a running container still mounts the config, detach is rejected with a 409 naming the blocking container — tear it down (or remove its json_configs block) and retry.