BahriyaBAHRIYAby Mamluk

Deploy Plain Configs with Reis (YAML Mode)

Use the Reis CLI to manage plain-text configuration files via YAML manifests. Plain configs are stored as-is (no schema validation) and mounted into containers at a path of your choosing.

Updated 23 Jun 20261 min read

Use the Reis CLI to manage plain-text configuration files via YAML manifests. Plain configs are stored as-is (no schema validation) and mounted into containers at a path of your choosing.

Example manifest

Create a file called plain-config.yml:

kind: plain_config
name: Nginx Config
handle: nginx-conf
content: |
  server {
    listen 8080;
    server_name app.example.com;
    location / {
      proxy_pass http://upstream;
    }
  }

Apply the manifest

reis apply -f plain-config.yml --org <organisation-id>

Required fields

FieldTypeDescription
kindstringMust be plain_config
namestringHuman-readable display name
handlestringDNS-1123-compliant identifier
contentstringArbitrary text content

Notes

  • The handle is immutable after creation.
  • Content is not validated — store any text you want (nginx configs, Caddy files, properties files, …).
  • To update content, change the content field and re-apply. This creates a new version (rotation).
  • Attach a plain config to a project with reis project:attach <project-id> plain_configs <handle> — see Commands Reference. Project YAML does not manage attachments.

See also