Skip to content

Digging Deeper

In this section we go over how to manage your collection of backups with the clan command.

Listing states

To see which files (states) will be backed up on a specific machine, use:

clan state list jon

This will show all configured states for the machine jon, for example:

· service: linkding
  folders:
  - /var/backup/linkding
  preBackupCommand: pre-backup-linkding
  postRestoreCommand: post-restore-linkding

· service: zerotier
  folders:
  - /var/lib/zerotier-one

Creating backups

To create a backup of a machine (e.g., jon), run:

clan backups create jon

This will backup all configured states (zerotier and linkding in this example) from the machine jon.

Listing available backups

To see all available backups, use:

clan backups list

This will display all backups with their timestamps:

storagebox::username@username.your-storagebox.de:/./borgbackup::jon-jon-2025-07-22T19:40:10
storagebox::username@username.your-storagebox.de:/./borgbackup::jon-jon-2025-07-23T01:00:00
storagebox::username@username.your-storagebox.de:/./borgbackup::jon-storagebox-2025-07-24T01:00:00
storagebox::username@username.your-storagebox.de:/./borgbackup::jon-storagebox-2025-07-24T06:02:35

Restoring backups

For restoring a backup you have two options.

Full restoration

To restore all services from a backup:

clan backups restore jon borgbackup storagebox::u444061@u444061.your-storagebox.de:/./borgbackup::jon-storagebox-2025-07-24T06:02:35

Partial restoration

To restore only a specific service (e.g., linkding):

clan backups restore --service linkding jon borgbackup storagebox::u444061@u444061.your-storagebox.de:/./borgbackup::jon-storagebox-2025-07-24T06:02:35