Skip to content

Installation

This guide installs a complete single-server NGBackup site, then shows how to add File Daemons on the machines you want to protect. Everything installs under /opt/backup/.

  • A 64-bit Linux server (Ubuntu/Debian, RHEL/Rocky/Alma, SUSE, or Arch/Manjaro/BigLinux), Windows, or macOS for clients.
  • PostgreSQL — the only supported catalog database. (MySQL/MariaDB- and SQLite-compatible binaries can be developed on special order.)
  • Root (or sudo) on the server that will run the Director and Storage Daemon.

Pick your platform:

Debian / Ubuntu
sudo apt install backup-dir backup-sd backup-fd backup-console
RHEL / Rocky / Alma
sudo dnf install backup-dir backup-sd backup-fd backup-console
Arch / Manjaro / BigLinux
sudo pacman -S backup

This installs the programs in /opt/backup/bin/ and sample configuration in /opt/backup/etc/.

Terminal window
# PostgreSQL example
sudo -u postgres createuser backup
sudo -u postgres createdb -O backup backup
/opt/backup/bin/backup-dbcheck --create-schema

The Director stores every job, file and volume here, which is what makes restores fast.

The defaults work out of the box for a local backup. The files live in /opt/backup/etc/:

FileService
backup-dir.confDirector
backup-sd.confStorage Daemon
backup-fd.confFile Daemon
backup-console.confConsole

Validate any config before starting a service:

Terminal window
/opt/backup/bin/backup-dir -t -c /opt/backup/etc/backup-dir.conf
Terminal window
sudo systemctl enable --now backup-sd backup-dir backup-fd

Confirm they’re listening (Director 9101, File Daemon 9102, Storage Daemon 9103):

Terminal window
/opt/backup/bin/backup-console
* status director

On each machine you want to back up, install just the File Daemon. It is flag-driven — no config file required, which is ideal for automation and containers:

Terminal window
backup-fd --fd-address 0.0.0.0 --fd-port 9102 \
--sd-address backup-server --sd-port 9103

Then add a matching Client resource on the Director (see Configure → Client).

Next: run your first backup in Getting started.