Deploy Plain Configs with Reis (Flag Mode)

Deploy plain-text configuration files to Bahriya with Reis flags: create from a file or inline, rotate content, roll back versions, and attach to projects.

Updated 31 Oct 20262 min read

Use the Reis CLI to manage plain-text configuration files (no schema validation — Reis stores whatever you give it). Plain configs are mounted into a container at a path of your choosing.

Create a plain config

# From a file
reis plain_config:create \
  --org <organisation-id> \
  --name "Nginx config" \
  --handle nginx-conf \
  --content_file ./config/nginx.conf
 
# Or inline
reis plain_config:create \
  --org <organisation-id> \
  --name "Greeting" \
  --handle greeting \
  --content "Hello, world"

List plain configs

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

Shows a table with handle, name, and content length 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 plain config

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

Rotate (update content)

reis plain_config:rotate <config-id> \
  --org <organisation-id> \
  --content_file ./config/nginx-v2.conf

List versions

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

Activate a previous version

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

Delete a plain config

reis plain_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 the config content
`--content`	Inline content string (alternative to `--content_file`)

Provide exactly one of --content_file or --content.

Attach to a project

reis project:attach <project-id> plain_configs nginx-conf

Singular alias plain_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> plain_configs nginx-conf

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