Database Backups

2 min readUpdated Feb 26, 2026

Supported databases

Pink Narwhal can back up three types of databases:

  • MySQL / MariaDB (they are wire-compatible, so both work the same way)
  • PostgreSQL
  • MongoDB

Adding a database connection

  1. Go to the Databases page in your dashboard
  2. Click Add Database
  3. Choose your database type
  4. Enter the connection details: host, port, username, and password
  5. Click Test Connection to verify it works
  6. Select which databases on the server you want to back up
  7. Save

Your credentials are encrypted at rest. We never store passwords in plaintext.

How database backups work

Database backups run on the same hourly schedule as server backups. Pick a minute (0 to 59), and your selected databases are dumped at that time every hour.

The backup format depends on your database type:

DatabaseFormatExtension
MySQL / MariaDBFull SQL dump (schema + data).sql.gz
PostgreSQLpg_dump output.sql.gz
MongoDBJSONL (one document per line, grouped by collection).jsonl.gz

All dumps are compressed with gzip and streamed directly to Cloudflare R2.

Scheduling

Works the same as server backups. Each database connection has its own schedule minute. You can pause and unpause database backups independently.

Downloading database backups

Database backups appear in your backups table alongside server backups. Click the download button to get a signed URL for the dump file.

Important

Database backups are download-only. There is no automatic restore through the dashboard. To restore a database dump, download the file and use your database client (like mysql, psql, or mongorestore) to import it. This is intentional. Automatically writing data into a live database is the kind of thing that deserves manual oversight.

Storage and retention

Database backups share your plan's storage pool with server backups. A 50 MB SQL dump and a 50 MB server archive both count the same way. Retention rules apply equally.

Permissions

Admins can add and manage database connections. Members can view existing databases and their backups.

Was this article helpful?