Loading Smiley Hoster
Skip to content

Preview a restic retention policy for your VPS

Smiley Hoster Team · · 2 min read
A backup timeline separates retained snapshots from proposed removals.

Infrastructure automation, illustrated by Vultr's Cycle.io MCP announcement, makes routine changes easier to request. Backup cleanup needs its own acceptance step: preview the restore points you would retain before turning a policy into a scheduled deletion.

1. Start with a recovery requirement

This walkthrough assumes restic already backs up your VPS to a repository you can access. Use your established repository configuration and secure authentication method. Keep passwords out of commands copied into tickets or operating notes.

Write down the question the policy must answer. For example, how far back should you be able to recover a file after an unnoticed mistake? Choose this requirement with the person responsible for the data. Storage pressure alone should not decide which history matters.

Inventory the existing snapshots:

Example
restic snapshots

Find the hostname and paths recorded for the VPS. The following example uses vps-prod, which you must replace. Check whether the machine was renamed or its backup paths changed. A shared repository may hold several unrelated systems, so begin with a clearly scoped review.

Make a small worksheet with the recovery need, relevant paths and an example snapshot that meets it. This becomes your basis for accepting or rejecting the policy.

2. Preview the proposed selection

Run this illustrative policy without applying it:

Example
restic forget --host vps-prod \ --keep-daily 7 --keep-weekly 4 \ --keep-monthly 6 --dry-run

The numbers are examples to evaluate, not a standard retention requirement. Restic normally groups snapshots by hostname and paths. Read the preview for each group rather than treating the repository as one continuous history.

Retention rules overlap, so adding the three numbers does not give an exact snapshot count. Missing backup periods also remain missing. Keeping more history cannot recreate a backup that never happened.

Check the retained list against a recent accidental edit, a mistake discovered later, and a request for an older version. For each scenario, identify the snapshot you would use. Mark any case where you cannot find an acceptable point.

3. Approve the policy before any deletion

Save the review date, repository identity, hostname filter and relevant paths. If others depend on the repository, ask them to assess the same preview. They may know about a historical version that still needs protection.

Separate two operations in your procedure: forget removes snapshot references; prune reclaims data no longer needed. This exercise performs neither actual deletion nor space recovery. Do not add destructive cleanup to your backup schedule just because the preview command completed successfully.

The acceptance result is a documented retention decision backed by identifiable restore points and a restoration test. If a requirement is unmet, revise the backup frequency or retention choice first, then preview again before scheduling cleanup.

Sources: Vultr, restic — retention.

Slide 1 of 5: VPS backups. Preview your retention policy. Check the restore points you would keep before approving backup cleanup.
Slide 2 of 5: Step 1 of 3. Define your recovery needs. Agree how far back you need to recover. Inventory snapshots with restic snapshots, then check the VPS hostname and paths. Account for renamed hosts or changed paths.
Slide 3 of 5: Step 2 of 3. Check the dry run. Preview restic forget with --dry-run and the correct host filter. Review each hostname and path group. Match retained snapshots to recovery scenarios; missing backups stay missing.
Slide 4 of 5: Step 3 of 3. Approve before deletion. Record the date, repository, host filter and paths. Confirm restore points with a restoration test. Keep forget and prune separate: one removes references; the other reclaims unused data.
Slide 5 of 5: Read the full guide. Make retention a reviewed decision. If a recovery need is unmet, revise backup frequency or retention and preview again before scheduling cleanup.
On social media

See it in our social posts

The key steps of this article, as a carousel. Follow us to catch the next ones.

Did this article answer your question?
Your feedback shapes what we write next.

Your site online today

Free migration* · 30-day refund

Get started* A site under 30 GB, cPanel, WordPress and VPS plans.