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.