A wrapper script for Kopia Backup Software to send notifications when running on headless servers. This functionality is sorely missing from Kopia at this time.
kopia-wrapper captures the output and return codes from executing Kopia snapshot and maintenance commands. Notifications may be sent for every execution, or only for errors. Backup policies are retrieved from kopia and snapshots performed sequentially. It is expected that Kopia will provide it's own notification system in the future and kopia-wrapper would no longer be necessary in favour of running kopia server instead. By keeping policy definitions within Kopia, migration to Kopia server should be as simple as setting a schedule for each policy and using systemd to start the service.
- Supports Apprise Push Notifications to send notifications to many popular services.
- Do not set a schedule for Kopia policies. It is ignored by kopia-wrapper and would cause Kopia server (or kopia-ui) to perform snapshots itself if it is running (which contradicts the whole purpose of kopia-wrapper).
- Install Kopia
- Clone kopia-wrapper Git repository
sudo git clone https://github.com/GoyaPtyLtd/kopia-wrapper.git /etc/kopia-wrapper/ - Initialise kopia-wrapper
cd /etc/kopia-wrapper sudo cp kopia-environment.conf.example kopia-environment.conf sudo cp kopia-wrapper.conf.example kopia-wrapper.conf sudo chmod og-rwx kopia-environment.conf kopia-wrapper.conf - Edit kopia-wrapper conf files
- Retention
- Compression
kopia policy set --before-snapshot-root-action </full/path/to/script.sh> </full/path/to/backup/>