gokrazy/website/content/userguide/rsync-backups.markdown

title, menuTitle, weight

title	menuTitle	weight
Permanent data backup with the gokrazy rsync	Data backup with rsync	80

I like to periodically back up all scans from my scan2drive appliance to my PC. The PC is backed up as well, so that automatically distributes my scans to multiple machines in case one of them fails.

A convenient way to set up an efficient partial or full backup of a gokrazy device’s permanent data partition is to use the gokrazy rsync daemon. This article walks you through how I have set up my backup, but many variants are possible to cater to different requirements.

(You don’t typically need backups of your gokrazy device’s root partition because it can be built reproducibly any time using Go.)

Step 1. Install the gokrazy rsync daemon

Add the gokrazy rsync implementation gokr-rsync to your gokrazy instance:

gok add github.com/gokrazy/rsync/cmd/gokr-rsync

Step 2. Configure the gokrazy rsync daemon

Open your gokrazy instance’s config.json in your editor:

gok edit

Configure Package config: Command-line flags and Package config: Extra files:

{{< highlight json "hl_lines=11-21" >}} { "Hostname": "backedup", "Packages": [ "github.com/gokrazy/fbstatus", "github.com/gokrazy/hello", "github.com/gokrazy/serial-busybox", "github.com/gokrazy/breakglass", "github.com/gokrazy/rsync/cmd/gokr-rsync" ], "PackageConfig": { "github.com/gokrazy/rsync/cmd/gokr-rsync": { "Basename": "rsync", "CommandLineFlags": [ "--daemon", "--gokr.config=/etc/gokr-rsyncd.toml" ], "ExtraFilePaths": { "/etc/gokr-rsyncd.toml": "gokr-rsyncd.toml", "/etc/gokr-rsyncd.authorized_keys": "gokr-rsyncd.authorized_keys" } } } } {{< /highlight >}}

In the daemon config file, configure an authorized SSH listener and which rsync modules to serve:

cat > ~/gokrazy/hello/gokr-rsyncd.toml <<'EOT'
dont_namespace = true 
[[listener]]
  [listener.authorized_ssh]
    address = "scan2drive.lan:22873"
    authorized_keys = "/etc/gokr-rsyncd.authorized_keys"
[[module]]
  name = "scans"
  path = "/perm/scans"
EOT

Finally, create the authorized keys file that determines who can access the rsync daemon:

cat > ~/gokrazy/hello/gokr-rsyncd.authorized_keys <<'EOT'
ssh-ed25519 […] michael@midna
EOT

Then, deploy as usual:

gok update

Step 3. Configure SSH from the backup machine

On your PC (not the gokrazy instance), add an SSH configuration stanza to your ~/.ssh/config to configure the custom port (22873 for ssh+rsync) and which passwordless identity file to use (for the cron job in step 4):

Host scan2drive-backup
    Hostname scan2drive.lan
    Port 22873
    IdentityFile ~/.ssh/id_ed25519_scan2drivebackup

Now you should be able to run rsync via SSH as usual:

rsync -av -e ssh rsync://scan2drive-backup/scans/ ~/scan2drive-backup/

Step 4. Configure a daily cron job

First, install the rsync-prom tool to monitor your periodic transfer with Prometheus:

go install github.com/stapelberg/rsyncprom/cmd/rsync-prom@latest

Then wrap the above rsync command in an rsync-prom invocation in a shell script called scan2drive-backup-sync.sh:

#!/bin/sh
SSH_AUTH_SOCK= ~/go/bin/rsync-prom --instance="scan2drive@midna" \
  rsync -av -e ssh rsync://scan2drive-backup/scans/ ~/scan2drive-backup/

Finally, run crontab -e and run the script at your convenience, like so:

30 07 * * * /home/michael/scan2drive-backup-sync.sh