Deploy YAML Configs with Reis (Flag Mode)

Create and manage YAML configs with Reis flag-mode commands: create from a content file, rotate, list versions, roll back, and attach to Bahriya projects.

Updated 31 Oct 20261 min read

Create and manage YAML configs directly from the command line using Reis flag-mode commands.

Create a YAML config

reis yaml_config:create \
  --name "App Config" \
  --handle app-config \
  --content_file ./configs/app.yaml

The content file must contain valid YAML. The handle must be DNS-1123 compliant (lowercase alphanumeric and hyphens, max 63 characters).

List YAML configs

reis yaml_config:list

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 details

reis yaml_config:show <config-id>

Displays metadata and the full YAML content.

Rotate content

reis yaml_config:rotate <config-id> \
  --content_file ./configs/app-v2.yaml

Creates a new version and marks it current. The previous version is retained for rollback.

List versions

reis yaml_config:versions <config-id>

Activate a previous version (rollback)

reis yaml_config:activate_version <config-id> <version-number>

Delete a YAML config

reis yaml_config:delete <config-id>

Add --force to skip the confirmation prompt. Deleting removes all versions, project attachments, and container wiring.

Attach to a project

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

Singular alias yaml_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> yaml_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 yaml_configs block) and retry.