Skip to content

Backups & Upgrades ​

What to back up ​

DataWhereBacked up automatically?
Database (users, tasks, conversations, settings)/data/meowbert/postgres-dataYes, as weekly dumps in /data/meowbert/postgres-backups
Project and task files/srv/meowbert/runtimeNo
Cold task history, if enabledThe archive mount and archivesDir configured under taskHistoryArchiveNo
Your configurationconfig/global.docker.json, .envNo

The postgres-backup service writes a compressed pg_dump every Sunday at midnight and keeps two weeks by default. Change the schedule and retention in .env (MEOWBERT_POSTGRES_BACKUP_SCHEDULE, MEOWBERT_POSTGRES_BACKUP_KEEP_WEEKS, …).

For a complete backup, copy the database dumps, /srv/meowbert/runtime, any separate cold-history archive, and your config files to another machine or storage with your usual tool, such as restic, borg, or rsync.

Cold storage moves message bodies, media, and execution history out of PostgreSQL. A database dump keeps their identities and archive references, but cannot recover those payloads without the archive files. Keep the archive and database backups together, including any older single-file archives retained during conversion.

Restoring the database ​

bash
gunzip -c /data/meowbert/postgres-backups/last/<backup>.sql.gz \
  | docker compose exec -T meowbert-postgres psql -U postgres -d meowbert

Restore into an empty database, before starting the API and worker. Restore the project files and matching cold-history archive too, and make its configured mount available to both services before starting them.

Upgrading ​

bash
git pull
docker compose pull sandbox-runtime
docker compose up -d --build

If you run the full stack with email, add -f docker-compose.full.yml to both docker compose commands.

Database migrations run automatically when the API starts. Check the changelog before upgrading for anything that needs your attention.