BahriyaBAHRIYAby Mamluk

Deploy YAML Configs with Reis (YAML Mode)

YAML configs can be declared in your bahriya.yml file under the configs section and applied with reis apply.

Updated 23 Jun 20261 min read

YAML configs can be declared in your bahriya.yml file under the configs section and applied with reis apply.

YAML structure

configs:
  yaml_configs:
    app-config:
      name: App Config
      content: "{{ file:./configs/app.yaml }}"

The {{ file:./path }} helper reads the file content at apply time, so you can keep your config files separate from the YAML declaration.

Attaching to a project

projects:
  production:
    attachments:
      configs:
        yaml_configs: [app-config]

Wiring to a container

Once attached to a project, reference the YAML config in a container definition:

containers:
  api:
    project: production
    image: ghcr.io/myorg/api:latest
    configs:
      yaml_configs:
        - handle: app-config
          mountpath: /etc/config/app

The config file is mounted as config.yaml under the specified mount path.

Rotation

To rotate, update the config file on disk and run reis apply again. A new version is created and marked current. Previous versions are retained for rollback.

See also