LaunchKit · 2026
Back to Skills

restic-home-backup

Design, implement, and operate encrypted restic backups for Linux home directories with systemd automation.

0
520 downloads
by @moep90

Setup & Installation

openclaw skills install @moep90/restic-home-backup

Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:

npx clawhub install restic-home-backup

Version History

v1.0.2Feb 15, 2026 - Version note by skill developer:

Hardening: default plan-only mode, explicit --apply for system writes, and opt-in flags for timers/init/initial run.

What This Skill Does

Sets up encrypted, versioned restic backups for a Linux home directory with systemd scheduling, retention policies, and restore validation. Covers repository initialization, credential hardening, prune/check automation, and recovery testing. Changes require explicit confirmation before writing to system paths.

Combines restic's deduplication and encryption with systemd timers and a validated restore step, which most manual backup guides omit.

When to use it

  • Set up daily automated backups of home directory to an S3 bucket
  • Configure weekly prune and monthly integrity check schedules
  • Restore files from a specific snapshot to a temporary directory
  • Harden backup credentials with restricted file permissions
  • Troubleshoot a failed backup due to wrong password or unreachable repo

Example Workflow

Here's how your AI assistant might use this skill in practice.

INPUT

User asks: set up encrypted daily backups of my home directory to an SFTP server with 7-day/4-week/12-month retention

AGENT
  1. 1Collect source path, SFTP endpoint, retention policy, and schedule from user
  2. 2Generate /etc/restic-home.env with restricted permissions and backup/prune/check scripts under /usr/local/bin
  3. 3Create systemd service and timer units for backup, prune, and check jobs
  4. 4Initialize the restic repository and run an immediate backup, then list snapshots to confirm
  5. 5Run a restore smoke test to a temporary directory and report exit status
OUTPUT

Fully configured restic setup with systemd timers active, one verified snapshot, and a restore smoke test confirming recovery works

Requirements

Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.

restic binary installed on the systemSFTP, S3, Backblaze B2, or local disk repository endpoint and credentialsRESTIC_PASSWORD or path to a password file for repository encryption