Skip to content

Backup Configurations

Backup configurations (Storage > Backup Configurations) define where and how server backups are stored: local disk, S3, restic, Proxmox Backup Server, Kopia, or a filesystem snapshot.

INFO

This page only describes the admin UI surface. The full walkthrough, including every per-disk field, driver comparison, and assignment guide, lives at Setting up Backup Configurations.

The list shows each configuration's ID, Name, Disk, and Created.

Backup configurations list

Creating a Configuration

Click Create. The common fields are Name, Backup Disk (Local, S3, Ddup-Bak, Btrfs, ZFS, Restic, Proxmox Backup Server, or Kopia), Description, and two switches:

Create backup configuration form

  • Maintenance Enabled: "If enabled, any server using this backup configuration will not be able to create new backups, or manage existing ones."
  • Shared: "If enabled, backups on this backup configuration will not be transferred between nodes, they will be assumed to be accessible by all nodes."

Picking S3, Restic, Proxmox Backup Server, or Kopia reveals a disk-specific settings section; the node-local disks need none. See the per-disk field reference for what goes in each. Btrfs, ZFS, and Ddup-Bak show a warning with extra requirements when selected.

Finish with Save or Save & Stay; View Documentation links to the walkthrough above.

Where Configurations Attach

A configuration takes effect once it's assigned to a location, node, or server; the panel picks the most specific one when a backup is created (server first, then node, then location). Assignment happens on those resources' own edit forms, each of which has a Backup Configuration field. See Assigning a Backup Configuration.

Opening a configuration shows tabs for General (the edit form, plus Duplicate and Delete), Stats, Backups, and read-only Locations, Nodes, and Servers lists showing where it's currently assigned; the tab lists are all searchable.

Configuration general tab

Stats counts total, successful, failed, and deleted backups, with stored sizes, across all time, today, this week, and this month.

Stats tab

Backups lists every backup stored on the configuration: Name, Server, Node, Checksum, Size, Files, and Created.

Backups tab

Locations tab

Nodes tab

Servers tab

Managing configurations requires the backup-configurations.create, backup-configurations.update, and backup-configurations.delete admin permissions; the Backups tab uses backup-configurations.backups. See the Permissions Reference.