Skip to content

Linux packages

Every release ships .deb, .rpm and .apk packages for fallbck-server and fallbck-agent. Grab them from the releases page.

Package Service Config
fallbck-server systemd (deb/rpm) or OpenRC (apk) unit fallbck-server, runs as user fallbck /etc/fallbck/server.yaml, secrets in /etc/fallbck/server.env
fallbck-agent systemd / OpenRC unit fallbck-agent, runs as root /etc/fallbck/agent.env (optional self-enrollment, DB profiles). State, spool and agent.yaml live in /var/lib/fallbck/agent, and there's an example config in /usr/share/doc/fallbck-agent/

Server

apt install ./fallbck_server_Linux_amd64.deb      # or rpm -i / apk add --allow-untrusted
$EDITOR /etc/fallbck/server.yaml /etc/fallbck/server.env
systemctl enable --now fallbck-server

On Alpine: rc-update add fallbck-server default && rc-service fallbck-server start.

Agent

apt install ./fallbck_agent_Linux_amd64.deb
fallbck-agent enroll --server https://backup.example.com --token <enrollment token>
systemctl enable --now fallbck-agent

Want the same box to do database dumps? Install the client tools next to it. No second agent needed:

apt install postgresql-client mariadb-client      # whichever engines you back up
fallbck-agent tools                               # shows what it found

Upgrades

Install the new package over the old one (apt install ./…deb, rpm -U, apk add). If the service is running, it gets restarted so the new binary takes over right away. A stopped or not-yet-enrolled service is left alone and you get the post-install hint instead.

Upgrades never touch your data, enrollment or config files. A backup that's running on that host when the restart happens gets cut off, and the server retries it on the next scheduled run.

Linux agents can also update themselves from the server, so you don't have to chase every box after a server upgrade.