{{define "content"}}

Backup & migration

Full backup

Download a self-contained backup of the whole instance — data/ (database, DKIM keys, application credentials, and the Postfix queue), docker-compose.yml, .env, and certs/. Extract it into an empty project directory on a new machine, adjust hostname or proxy settings if needed, and start a container of the same SelfPost version before first boot. The reverse-proxy vhost is not included — set that up separately on the new host.

The backup file is a secret (it contains private keys, TLS material, and credentials). Store and transfer it securely and delete it once the restore succeeds. Encrypting it below is the simplest way to do that: the download is then a .spbk file (SelfPost backup) that only the password opens.

{{if .BackupErr}}

{{.BackupErr}}

{{end}}
{{template "encryptfields" .}}

Import a domain

Move a single domain here from another SelfPost instance using a domain export file (from that domain's page) — plain .json or encrypted .spde (SelfPost domain export). Its DKIM key and application passwords come across, so the published DNS record needs no change. The export file is a secret, like a full backup.

{{if .ImportErr}}

{{.ImportErr}}

{{end}}
{{end}}