Skip to content

Configuration

Nimbus projects are configured with a nimbus.yml file at the root of your repository.

nimbus.yml
project: my-project
region: eu-west-1
buckets:
  - name: my-first-bucket
    retention_days: 30
    encryption: aes-256
webhooks:
  - url: https://example.com/webhooks/nimbus
    events: [record.created, record.deleted]

Environment overrides

Any top-level key can be overridden per environment:

nimbus.yml
project: my-project
region: eu-west-1

environments:
  staging:
    region: us-east-1
  production:
    region: eu-west-1
    encryption: aes-256

Apply a config with:

nimbus config apply --env production

Tip

Run nimbus config validate before applying to catch schema errors early.