Configuration

Mammoth uses YAML configuration validated by JSON Schema.

Add this comment at the top of config files to enable editor validation when using a YAML language server:

# yaml-language-server: $schema=./mammoth.schema.json

Full example

mammoth:
  name: local_mammoth

postgres:
  host: localhost
  port: 5432
  database: app_development
  username: mammoth
  password_env: MAMMOTH_POSTGRES_PASSWORD

replication:
  slot: mammoth_prod
  publications:
    - mammoth_publication
  auto_create_slot: false
  temporary_slot: false
  feedback_interval: 10.0

webhook:
  name: primary_webhook
  url: https://example.com/webhooks/postgres
  timeout_seconds: 5

retry:
  max_attempts: 5
  schedule_seconds:
    - 1
    - 5
    - 30
    - 60
    - 300

sqlite:
  path: data/mammoth.db

logging:
  level: info

Sections

mammoth

mammoth:
  name: local_mammoth

name identifies this Mammoth instance in operational state and logs.

postgres

postgres:
  host: localhost
  port: 5432
  database: app_development
  username: mammoth
  password_env: MAMMOTH_POSTGRES_PASSWORD

password_env names the environment variable containing the PostgreSQL password. Mammoth reads the password from the environment rather than storing it directly in YAML.

replication

replication:
  slot: mammoth_prod
  publications:
    - mammoth_publication
  auto_create_slot: false
  temporary_slot: false
  feedback_interval: 10.0

• slot is the logical replication slot name.
• publications is the list of PostgreSQL publications to subscribe to.
• auto_create_slot controls whether Mammoth attempts to create the slot.
• temporary_slot controls whether the replication slot is temporary.
• feedback_interval controls standby feedback cadence in seconds.

webhook

webhook:
  name: primary_webhook
  url: https://example.com/webhooks/postgres
  timeout_seconds: 5

name is used in operational records such as dead letters. url is the destination endpoint.

retry

retry:
  max_attempts: 5
  schedule_seconds:
    - 1
    - 5
    - 30
    - 60
    - 300

Mammoth retries failed deliveries according to this schedule. When retries are exhausted, failed events are persisted as dead letters.

sqlite

sqlite:
  path: data/mammoth.db

SQLite stores operational memory: schema migrations, checkpoints, and dead letters.

logging

logging:
  level: info

Valid levels are:

debug
info
warn
error

Validate config

mammoth validate config/mammoth.yml