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)

Referenced By

btrfs-backup-ng(1).

January 2026 btrfs-backup-ng