btrfs-backup-ng-install - Man Page
install systemd timer/service
Synopsis
btrfs-backup-ng install [Options]
Description
Generate and install systemd units for automated backups. Creates both a service unit and a timer unit that runs backups on a schedule.
By default, installs system-wide services requiring root privileges. Use --user for user-level services.
Options
- --timer PRESET
Use a preset timer interval. Valid presets: hourly, daily, weekly.
- --oncalendar SPEC
Custom OnCalendar specification for flexible scheduling.
Examples:
- *:0/15
Every 15 minutes
- *:0/5
Every 5 minutes
- *-*-* 02:00:00
Daily at 2 AM
- Mon *-*-* 03:00:00
Every Monday at 3 AM
- --user
Install as a user service instead of a system service. Does not require root privileges and runs in the user's session.
Generated Files
System Installation
- /etc/systemd/system/btrfs-backup-ng.service
Service unit file.
- /etc/systemd/system/btrfs-backup-ng.timer
Timer unit file.
User Installation
- ~/.config/systemd/user/btrfs-backup-ng.service
User service unit file.
- ~/.config/systemd/user/btrfs-backup-ng.timer
User timer unit file.
Examples
- Install hourly timer (system-wide):
sudo btrfs-backup-ng install --timer hourly
- Install daily timer at 2 AM:
sudo btrfs-backup-ng install --oncalendar *-*-* 02:00:00
- Install every 15 minutes:
sudo btrfs-backup-ng install --oncalendar *:0/15
- Install as user service:
btrfs-backup-ng install --timer hourly --user
Post-Installation
After installation, the timer is automatically enabled and started.
To check status:
systemctl status btrfs-backup-ng.timer systemctl list-timers btrfs-backup-ng.timer
For user services:
systemctl --user status btrfs-backup-ng.timer
See Also
btrfs-backup-ng(1), btrfs-backup-ng-uninstall(1), systemd.timer(5), systemd.time(7)