Skip to main content
Runs connectivity and configuration checks without creating a backup. Always run this after dbdock init, after changing credentials, or before relying on DBDock in production.

What it checks

Database

Connects to Postgres, runs a test query, verifies pg_dump availability.

Storage

Authenticates with the storage provider and attempts a list + upload of a tiny test object.

Encryption

Validates DBDOCK_ENCRYPTION_SECRET exists and is a valid 64-char hex key (if encryption is enabled).

Alerts

Sends a test notification to configured Slack/email channels (if enabled).

Sample output

When a check fails

Failed checks tell you exactly what to fix:
Exit code is 1 on any failure — safe to use in CI as a preflight.

Use in CI

Add a preflight step to your pipeline:
If anything is misconfigured, the deploy fails fast instead of silently producing broken backups.

See also

Troubleshooting

What to do when a check fails.