diff --git a/README.md b/README.md index 355edb1..16af4fc 100644 --- a/README.md +++ b/README.md @@ -123,3 +123,133 @@ Restart=always `systemctl --user daemon-reload` `systemctl --user start cloud-pod.service ` + +## Backups + +### Install Borg Backup + +Enable EPEL + +`sudo dnf install epel-release` + +Install Borg + +`sudo dnf install borgbackup` + +### Setup backup storage + +Make the directory (normally this would be on a dedicated harddrive mounted at `/mnt/backup-drive`) + +`sudo mkdir -p /mnt/backup-drive/backups` + +Give yourself ownership of the backups folder + +`sudo chown : /mnt/backup-drive/backups` + +Initialize the backup respoitory + +`borg init --encryption=repokey /mnt/backup-drive/backups` + +### Perform backup + +```sh +# Stop containers +systemctl --user stop cloud-pod.service + +# Backup Postgresql podman volume +podman volume export postgresql-data | borg import-tar --stats /mnt/backup-drive/backups::postgresql_$(date +%Y-%m-%d_%H-%M) - + +# Backup Nextcloud podman volume +podman volume export nextcloud-data | borg import-tar --stats /mnt/backup-drive/backups::nextcloud_$(date +%Y-%m-%d_%H-%M) - + +# Start Containers +systemctl --user start cloud-pod.service +``` + +### Restore Backup + +Stop Containers + +`systemctl --user stop cloud-pod.service` + +List backups + +`borg list /mnt/backup-drive/backups/` + +Import backups back to podman volumes +**(replace the backup name based on the date-time)** + +```sh +borg export-tar /mnt/backup-drive/backups::postgresql_2026-11-09_21-51 - | podman volume import postgresql-data - + +borg export-tar /mnt/backup-drive/backups::nextcloud_2026-11-09_22-09 - | podman volume import nextcloud-data - +``` + +Start Containers + +`systemctl --user start cloud-pod.service` + +### Automate Backups + +Create Script + +`nano ~/backup-nextcloud.sh` + +```sh +#!/bin/sh + +# Stop containers +systemctl --user stop cloud-pod.service + +# Backup Postgresql podman volume +podman volume export postgresql-data | borg import-tar --stats /mnt/backup-drive/backups::postgresql_$(date +%Y-%m-%d_%H-%M) - + +# Backup Nextcloud podman volume +podman volume export nextcloud-data | borg import-tar --stats /mnt/backup-drive/backups::nextcloud_$(date +%Y-%m-%d_%H-%M) - + +# Start Containers +systemctl --user start cloud-pod.service +``` + +Make the script executable + +`chmod +x ~/backup-nextcloud.sh` + +Create Service to run the script + +`nano ~/.config/systemd/user/backup-nextcloud.service` + +```ini +[Unit] +Description=Run backup script for nextcloud + +[Service] +Type=oneshot +ExecStart="/home//backup-nextcloud.sh" + +[Install] +WantedBy=default.target +``` + +Create Timer to run the service periodically + +`nano ~/.config/systemd/user/backup-nextcloud.timer` + +```ini +[Unit] +Description=Run nextcloud backup daily + +[Timer] +OnCalendar=*-*-* 4:00:00 +Persistent=true + +[Install] +WantedBy=timers.target +``` + +Reload systemd and enable timer + +```sh +systemctl --user daemon-reload +systemctl --user enable backup-nextcloud.timer +```