All Projects → Southclaws → Restic Robot

Southclaws / Restic Robot

Licence: mit
Backups done right... by robots! Restic backup but the robot friendly version.

Programming Languages

go
31211 projects - #10 most used programming language

Restic Robot

Backups done right... by robots!

This is a small and simple wrapper application for Restic that provides:

  • Automatically creates repository if it doesn't already exist
  • Scheduled backups - no need for system-wide cron
  • Prometheus metrics- know when your backups don't run!
  • JSON logs - for the robots!
  • Pre/post shell script hooks for custom behaviour! (Thanks @opthomas-prime!)

Usage

Just go build and run it, or, if you're into Docker, southclaws/restic-robot.

Environment variables:

  • SCHEDULE: cron schedule
  • RESTIC_REPOSITORY: repository name
  • RESTIC_PASSWORD: repository password
  • RESTIC_ARGS: additional args for backup command
  • RUN_ON_BOOT: run a backup on startup
  • PROMETHEUS_ENDPOINT: metrics endpoint
  • PROMETHEUS_ADDRESS: metrics host:port
  • PRE_COMMAND: A shell command to run before a backup starts
  • POST_COMMAND: A shell command to run if the backup completes successfully

Prometheus metrics:

  • backups_all_total: The total number of backups attempted, including failures.
  • backups_successful_total: The total number of backups that succeeded.
  • backups_failed_total: The total number of backups that failed.
  • backup_duration_milliseconds: The duration of backups in milliseconds.
  • backup_files_new: Amount of new files.
  • backup_files_changed: Amount of files with changes.
  • backup_files_unmodified: Amount of files unmodified since last backup.
  • backup_files_processed: Total number of files scanned by the backup for changes.
  • backup_added_bytes: Total number of bytes added to the repository.
  • backup_processed_bytes: Total number of bytes scanned by the backup for changes

It's that simple!

Docker Compose

Stick this in with your other compose services for instant backups!

services:
  #
  # your stuff etc...
  #

  backup:
    image: southclaws/restic-robot
    restart: always
    environment:
      # every day at 2am
      SCHEDULE: 0 0 2 * * *
      RESTIC_REPOSITORY: my_service_repository
      RESTIC_PASSWORD: ${MY_SERVICE_RESTIC_PASSWORD}
      # restic-robot runs `restic backup ${RESTIC_ARGS}`
      # so this is where you specify the directory and any other args.
      RESTIC_ARGS: /data
      B2_ACCOUNT_ID: ${B2_ACCOUNT_ID}
      B2_ACCOUNT_KEY: ${B2_ACCOUNT_KEY}
    volumes:
      # Bind whatever directories to the backup container.
      # You can safely bind the same directory to multiple containers.
      - "/container_data/blog/wordpress:/data/wordpress"
Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].