Fill the Server: 80% off your first 4 monthly invoices, monthly billing. Ends Nov 30, 2026. 25 spots in this batch.FILL25
Fill the Server, annual: about 29.63% off your first annual invoice. Ends Nov 30, 2026.FILL25Y
Fill the Server, 2 year term: about 15.69% off your first biennial invoice. Ends Nov 30, 2026.FILL25B
Fill the Server, 3 year term: about 11.11% off your first triennial invoice. Ends Nov 30, 2026.FILL25T
80% off your first 3 months, monthly billing. Ends Dec 25, 2027.3MONTHS80
50% off your first annual Shared term. Ends Dec 31, 2027.50SHARED
Shared Starter, 3 year term: C$105.84 total.MOOSE294
20% off your first 3 monthly VPS invoices. Ends Dec 31, 2027.20VPS3
25% off your first annual base VPS term.25VPS

← All guides

Backups

restic with S3-compatible storage: repository design and restore testing

Published August 2026 · 8 min read

restic can use S3-compatible storage as a backend while encrypting repository contents client-side. That makes the S3 credential and the restic repository password different pieces of the recovery path, and both need deliberate handling.

Separate the S3 key from the repository password

The S3 credential authorizes access to the bucket. The restic password protects the encrypted repository. Losing either can block recovery; leaking the S3 key does not automatically reveal plaintext if restic encryption remains intact.

Store the two secrets through a recoverable secret-management process and keep them out of unprotected scripts.

Use a dedicated bucket or project

Give the repository an isolated storage boundary and a credential that cannot enumerate unrelated customer data. This also makes quota and usage reconciliation easier to reason about.

Avoid reusing a shared administrator key across many backup hosts simply to simplify configuration.

Watch repository growth

Retention and deduplication affect how quickly restic consumes storage, but backend byte counts remain the authoritative capacity limit. Alert before the hard quota is close enough to interrupt a backup.

After large prune operations, allow for provider accounting delay before assuming all capacity has been reclaimed.

Run check and restore workflows

Use restic’s repository checking features as one signal, then perform actual restores of representative files to a separate location. Validate file contents and application usability where appropriate.

A repository that can list snapshots but cannot restore required data has failed the purpose of the backup.

Plan credential rotation without losing repository access

Replace the S3 credential independently from the restic password. Verify the new key can read and write the existing repository before revoking the old one.

Document how to recover the repository if the original backup host is gone, including endpoint, bucket, repository path, S3 key process and restic password recovery. Keep the first restore command and required environment variables in the runbook so a replacement host can be prepared without reconstructing the repository layout from memory.

Next step

Plan a restic repository on S3-compatible storage with isolated credentials, repository passwords, capacity monitoring, retention and regular restore checks.

Explore DotMoose Object Storage

Keep reading

Related guides.

boto3 S3-compatible storage: custom endpoint, put_object and connection tests

Connect boto3 to S3-compatible storage with endpoint_url. Start with a read-only list, then optionally verify put_object with one isolated write/read/delete round trip.

Read the guide

S3 multipart upload explained: part size, retries, checksums and cleanup

Learn how S3 multipart upload works: numbered parts, AWS part-size limits, parallel retries, completion, checksums and cleanup of abandoned uploads.

Read the guide

S3 presigned URLs explained: temporary access without sharing keys

Learn how S3 presigned URLs authorize a specific operation for a limited time, where they help, what they expose and how to use them safely.

Read the guide

More object storage guides

We will handle the move. You check it first.

Your current site stays online until your new one is ready. You approve the copy first, and if anything is not right we switch you back right away. The price you pick is the price you renew at.

Start my free moveSee plans and prices
See pricesFree move