What's New
NFS & Multiple Storage Location Fixes (#25)
- Fix borg init on NFS storage: Repository initialization now runs through
bbs-ssh-helperas root, resolving "Permission denied" errors when creating repos on NFS-mounted storage locations (Synology NAS, TrueNAS, generic Linux NFS) - Fix repo operations on non-default storage paths:
borg-list,borg-list-archive,borg-cmd(prune, compact, check, etc.) now support repositories on any registered storage location, not just/var/bbs/ - Fix chown failures on NFS: Ownership operations are now non-fatal — NFS with user mapping doesn't support chown, and it's not needed when all users map to the same NFS admin user
- Fix storage-paths not written on init failure:
.storage-pathsfile is now updated before borg init so SSH access works even if initialization needs to be retried - Fix NFS owner detection:
bbs-ssh-helpernow handles "UNKNOWN" UIDs from NFS stat by looking up the correct user from/etc/passwd - Extracted
is_allowed_path()helper inbbs-ssh-helperfor consistent path validation across all commands
Windows Agent Fix
- Fix Windows agent going offline after self-update: The agent update mechanism used
sc stop/sc startto restart the Windows service, which raced with the launcher's own restart loop and could leave the service permanently stopped. The agent now exits cleanly and lets the launcher handle the restart automatically.
⚠️ Windows Agent Users: If your Windows agent went offline after updating, the service has stopped and cannot pull the fix on its own. You need to restart the service manually by running
sc start BorgBackupAgentin an elevated command prompt, or restart the Windows machine. Once the service is running again, it will automatically update to the fixed agent version.
Catalog Rebuild Improvement
- Sync archives from borg before catalog rebuild: Catalog rebuild now runs
borg listfirst to discover any archives in borg that aren't yet in the database, ensuring rebuilds always work with fresh data
Documentation
- Updated Storage Setup wiki with comprehensive NFS setup instructions for Synology NAS, TrueNAS, and generic Linux — including Docker NFS volume configuration and troubleshooting
- Updated Docker Installation wiki with NFS/multi-storage setup, ARM/ClickHouse notes, and
.envpersistence details
Previous Beta Changes (since v2.14.0)
- Fix storage-paths not updated when default location differs from SSH home
- Add manual path restore/download when ClickHouse is unavailable (#30)
- Add 'Include beta versions' checkbox to update checker
- Fix Windows agent not restarting after sleep/wake