Skip to content

docs: automated-local: support multiple backup drives, fixes #9834 - #10545

Merged
ThomasWaldmann merged 1 commit into
borgbackup:masterfrom
ThomasWaldmann:docs-automated-local-multi-disk
Oct 24, 2026
Merged

ThomasWaldmann merged 1 commit into
borgbackup:masterfrom
ThomasWaldmann:docs-automated-local-multi-disk

Conversation

@ThomasWaldmann

Copy link
Copy Markdown
Member

Fixes #9834.

The udev rule in the "Automated backups to a local hard drive" guide matched a single partition table UUID, so only the first backup drive started the automatic-backup service, although run.sh accepts every filesystem UUID listed in backup.disks. The "Adding backup hard drives" section did not mention the udev rule at all.

Changes:

  • Match on ENV{ID_FS_UUID} (the filesystem UUID, the same one recorded in backup.disks) instead of the partition table UUID.
  • Document one rule line per backup drive, or |-separated UUID alternatives in one line.
  • Add the "add a udev rule line + udevadm control --reload" step to "Adding backup hard drives".
  • Update the overview and the stale sleep 5 comment in run.sh, which referred to the old, imprecise rule.

🤖 Generated with Claude Code

…up#9834

The udev rule matched a single partition table UUID, so only the first
backup drive started the backup service, although run.sh accepts every
filesystem UUID listed in backup.disks.

Match on the filesystem UUID (the same UUID as in backup.disks) instead,
document one rule line per backup drive (or "|" alternatives) and add
the udev rule step to "Adding backup hard drives".

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@ThomasWaldmann

Copy link
Copy Markdown
Member Author

Tested on Debian 13 (systemd 257) with the rule file + service unit from the guide (stub run.sh that only logs) and three loop-device images (GPT + ext4): A and B registered, C not.

Service runs per attach:

Rules file A B C
one ID_FS_UUID line for A 1 0 0
one line for A, one for B 1 1 0
one line with "A|B" 1 1 0
old rule (ID_PART_TABLE_UUID of A) 1 0 –

The last row reproduces #9834. The new rule fires exactly once per attach, and /dev/disk/by-uuid/<uuid> already exists when the service starts (mounting works).

Docs build: clean make html with 0 warnings on master and 1.4-maint.

@ThomasWaldmann
ThomasWaldmann merged commit 66aad2e into borgbackup:master Oct 24, 2026
1 check passed
@ThomasWaldmann
ThomasWaldmann deleted the docs-automated-local-multi-disk branch October 24, 2026 20:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

automated-local deployment with multiple HDDs

1 participant