docker-compose.override.yaml.example

# Local overrides: copy to docker-compose.override.yaml in this directory.
# Compose automatically merges this with docker-compose.yaml.
#
#   cp docker-compose.override.yaml.example docker-compose.override.yaml
#
# Volumes are APPENDED to the base file's volumes list, environment and other scalar keys are MERGED by key.
services:
  chatmail:
    volumes:
      ## Data paths — bind-mount to host directories for easy access/backup.

      # - ./data/dkim:/etc/dkimkeys
      # - ./data/certs:/var/lib/acme

      # - ./data/mail:/home/vmail
      ## Or mount from an existing bare-metal install.
      # - /home/vmail:/home/vmail

      ## Mount your own chatmail.ini (skips auto-generation):
      # - ./chatmail.ini:/etc/chatmail/chatmail.ini

      ## Custom website:
      # - ./data/www:/opt/chatmail-www

      ## Debug — mount scripts for live editing:
      # - ./scripts/chatmail-init.sh:/chatmail-init.sh
      # - ./scripts/entrypoint.sh:/entrypoint.sh

    # environment:
      ## Mount certs (above) and set TLS_EXTERNAL_CERT_AND_KEY to in-container paths.
      ## A tls-cert-reload.path watcher inside the container reloads services
      ## when the cert file changes. However, inotify does not cross bind-mount
      ## boundaries, so host-side renewals (certbot, acmetool, etc.) must
      ## notify the container explicitly. Add this to your renewal hook:
      ##
      ##   docker exec chatmail systemctl start tls-cert-reload.service
      ##
      ## Host acmetool (bare-metal migration): create mount above, and
      ##   rsync -a /var/lib/acme/live data/certs
      # TLS_EXTERNAL_CERT_AND_KEY: "/var/lib/acme/live/${MAIL_DOMAIN}/fullchain /var/lib/acme/live/${MAIL_DOMAIN}/privkey"
      ##
      ## (Untested) Traefik certs-dumper (see docker/docker-compose-traefik.yaml) - also add volume:
      ##   - traefik-certs:/certs:ro
      # TLS_EXTERNAL_CERT_AND_KEY: "/certs/${MAIL_DOMAIN}/certificate.crt /certs/${MAIL_DOMAIN}/privatekey.key"