Middleware Manager Docs

Backups & Persistence

What to back up and how to restore safely.

What to back up

  • SQLite DB: DB_PATH (default /data/middleware.db) — contains middlewares, services, assignments, mTLS state.
  • Traefik static config: /etc/traefik/traefik*.yml — plugins, entrypoints, logging, providers.
  • Templates: /app/config/templates.yaml, /app/config/templates_services.yaml.

Backup cadence

  • DB: before major changes; daily for active environments.
  • Static config: any time plugins/entrypoints/logging change; keep under version control.

Restore guidance

  • Stop Middleware Manager before restoring the DB to avoid concurrent writes.
  • After restoring static config, restart Traefik to apply plugins/entrypoints/logging.
  • Invalidate cache (/api/traefik-config/invalidate) so regenerated rules match DB state.

Screenshot placeholder — backup/restore steps diagram.

On this page