Backups
Where your instance keeps its data and secrets, so you know what to back up.
Metis Suite has no built-in backup or restore. Back up the data below with the tools you already use for Docker volumes and files on your server.
Most mail, events and files are not stored by Metis Suite at all. They stay with the provider or server each user connected, such as Gmail, Outlook or your IMAP server. Your instance keeps the accounts, the connections and their credentials, the settings, and what people create in the app.
What lives where
With the Compose stack installed in /opt/metis-suite:
| What | Where | Why it matters |
|---|---|---|
| The settings file, with every secret | /opt/metis-suite/.env |
Holds the encryption key, the app secret, the database credentials and the release pins. |
| The app database and the AI memory database | The metis_sqld Docker volume |
Accounts, workspaces, connections, settings and their history, workflows, scheduled mail, and the assistant’s memory. |
| HTTPS certificates | The metis_caddy_data Docker volume |
Caddy gets a new certificate if this is lost, so it is optional. |
| Updater state | /opt/metis-suite/.updater-state.json |
The last upgrade or rollback and the previous release. |
If your databases are on Turso, they live there instead of in the metis_sqld volume.
Mailbox gateways
If you run a Cloudflare Email or Resend gateway, it keeps its mail in its own storage, separate from your instance. Back it up there. See Mail gateways.