Deploy Plain Configs with Reis (Flag Mode)

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.

Updated 23 Jun 20261 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>

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.