Managing Backups

The backup list gives you an overview of all configured backups and quick access to common actions.

Viewing the Backup List

Navigate to Backups from the sidebar. Each backup entry shows:

• Scope icon — color-coded by type (purple for server, blue for app, green for database).
• Name — the scope and target (e.g., "App Backup — my-app").
• Server and destination — which server is being backed up and where snapshots are stored.
• Schedule — human-readable description of the cron schedule.
• History dots — the last 5 runs shown as colored circles (green = completed, blue = running, red = failed).
• Last run — relative timestamp of the most recent run.
• Status badge — Active or Paused.

Search and Filter

Use the controls above the list to narrow results:

• Search — type to filter backups by name, server, or destination (live search with 300ms debounce).
• Scope filter — show only Server, App, or Database backups.
• Server filter — show only backups for a specific server.

Running a Backup On-Demand

Click the play icon next to any backup to trigger an immediate run. The backup is queued and executes independently of its schedule. You can also run a backup from the detail page by clicking the Run Now button.

Toggling Active / Paused

Click the pause icon next to an active backup to pause it, or the play icon next to a paused backup to re-enable it. Paused backups will not run on their schedule but can still be triggered manually.

Viewing Backup Details

Click any backup row to open its detail page, which has four tabs:

History Tab

Lists every backup run with:

• Status (completed, running, or failed) with a colored indicator.
• Snapshot ID (first 8 characters).
• Start time, duration, and size.
• Number of new and changed files.
• Error message (if the run failed).

Snapshots Tab

See Restoring from a Backup for details on this tab.

Settings Tab

Update the schedule and retention settings for this backup:

1. Change the Schedule dropdown or enter a custom cron expression.
2. Adjust Keep Last N Snapshots and Keep Snapshots For (days).
3. Click Save Settings.

Danger Zone Tab

Permanently delete a backup configuration:

1. Switch to the Danger Zone tab.
2. Type DELETE in the confirmation field.
3. Click Delete Backup.

This removes the configuration and all history records from ServerPlane. The backup repository on the destination is not deleted — your existing snapshots remain intact.

Status Summary Cards

At the top of the detail page, four summary cards show the current status, last run time, next scheduled run, and retention policy at a glance.