Skip to content

Backups

Stackpad automatically backs up all database and cache services based on your organization’s plan. Backups are stored on European S3-compatible storage (MinIO).

Backup schedule

PlanFrequencyRetention
StarterDaily7 days
ProEvery 6 hours30 days
BusinessHourly90 days

How backups work

Stackpad uses the native backup tool for each database type:

DatabaseBackup toolFormat
PostgreSQLpg_dumpSQL dump
MariaDBmysqldumpSQL dump
RedisBGSAVERDB snapshot
ValkeyBGSAVERDB snapshot

Backups run inside the database container, so they capture a consistent snapshot. The backup file is uploaded to encrypted S3-compatible storage on European infrastructure.

Viewing backups

  1. Open your project and select the database service
  2. Go to the Backups tab
  3. You’ll see all available backups with timestamp, size, and status

Restoring a backup

Restoring a backup is a manual process. You download the backup file and apply it to your database.

Step 1: Download the backup

In the Backups tab, click Download on the backup you want to restore.

Step 2: Connect to your database

To run a restore command, you need a way to connect to your database. There are two options:

Option A: Enable public access (easiest)

  1. Go to the database service’s Settings tab
  2. Enable Public access — this exposes the database on a TCP port
  3. Copy the connection string shown in the dashboard
  4. Use this connection string in the restore command below

Option B: Run restore from within Stackpad

If you have a “service” type container in your project (e.g. a worker), you can run the restore command from there since it has private network access to the database.

Step 3: Run the restore

PostgreSQL

Terminal window
psql "postgresql://user:pass@host:port/dbname" < backup.sql

Or with the pg_restore tool if the backup is in custom format:

Terminal window
pg_restore -d "postgresql://user:pass@host:port/dbname" backup.dump

MariaDB

Terminal window
mysql -h host -P port -u user -p dbname < backup.sql

Redis / Valkey

Redis backups are RDB snapshot files. To restore:

  1. Stop the Redis service
  2. Replace the RDB data file
  3. Restart the Redis service

Step 4: Disable public access

If you enabled public access in step 2, remember to disable it after the restore is complete:

  1. Go to the database service’s Settings tab
  2. Toggle Public access off

Multiple backups

If your plan includes frequent backups (Pro: every 6 hours, Business: hourly), you can choose which backup to restore from. Each backup is a point-in-time snapshot — pick the one closest to the state you want to recover.

What’s next?

  • PostgreSQL — PostgreSQL-specific configuration and public access
  • MariaDB — MariaDB-specific configuration