@@ -0,0 +1,79 @@
+## Example setup
+
+[`keld/`](./keld/) is example content for `~/.config/keld`. It contains a config and some env files for the systemd stuff. [`systemd/user/`](./systemd/user/) contains that systemd stuff. Backup runs daily, verify runs monthly, both read from the env files to ping healthchecks.io and let you know whether your backups failed. Both also use mise to install/execute runitor (for healthchecks) and keld.
+
+[`config_long.toml`](./keld/config_long.toml) is more exhaustive.
+
+### 1. Copy the configs
+
+```bash
+mkdir -p ~/.config/keld/timers
+cp -r examples/keld/* ~/.config/keld/
+```
+
+### 2. Edit
+
+Open `~/.config/keld/config.toml` and customize it for your backups:
+
+- Define your presets (e.g., `media@hetzner_media`, `docs@b2_docs`)
+- Set your repository URLs
+- Configure environment variables for authentication
+- Set backup sources via `_arguments`
+
+Repeat this to add backups later.
+
+### 3. Set up healthchecks.io (optional)
+
+Create two checks on [healthchecks.io](https://healthchecks.io) for each backup:
+
+- One for the backup job
+- One for the verify job
+
+Create env files in `~/.config/keld/timers/`:
+
+```bash
+# ~/.config/keld/timers/mybackup@myrepo.env
+CHECK_UUID=your-backup-check-uuid-here
+
+# ~/.config/keld/timers/mybackup@myrepo-verify.env
+CHECK_UUID=your-verify-check-uuid-here
+```
+
+Repeat this to add backups later.
+
+### 4. Install the systemd units
+
+```bash
+mkdir -p ~/.config/systemd/user
+cp examples/systemd/user/* ~/.config/systemd/user/
+```
+
+### 5. Enable and start the timers
+
+For each backup preset you defined (e.g., `media@hetzner_media`):
+
+```bash
+# Escape the @ symbol for systemd instance names
+systemctl --user enable keld-backup@media@hetzner_media.timer
+systemctl --user start keld-backup@media@hetzner_media.timer
+
+systemctl --user enable keld-verify@media@hetzner_media.timer
+systemctl --user start keld-verify@media@hetzner_media.timer
+```
+
+Repeat this to add backups later.
+
+### 6. Verify everything is working
+
+```bash
+# List active timers
+systemctl --user list-timers
+
+# Check service status
+systemctl --user status keld-backup@media@hetzner_media.service
+
+# Test a dry run
+keld --dry-run media@hetzner_media backup
+```
+
+Repeat this to add backups later.