Set Up Automatic Incremental Backups on Linux with Restic and S3-Compatible Storage

Why Restic Is a Smart Backup Tool in 2026

Backups are one of those tasks everyone agrees are important—right up until storage fills up, scripts break, or restore day arrives and nothing works. If you need a modern backup solution for Linux servers, laptops, or small business systems, restic is a strong choice. It is fast, encrypted by default, supports incremental snapshots, and works well with local disks, SSH targets, and S3-compatible object storage (such as MinIO, Backblaze B2 S3, Wasabi, or many private clouds).

This tutorial shows how to configure automatic incremental backups with restic to an S3-compatible bucket, keep backups clean with retention policies, and validate that restores actually work. The goal is a setup you can run unattended with systemd timers.

Prerequisites

Before you start, you’ll need a Linux system with root or sudo access, network connectivity to your S3 endpoint, and an S3 bucket created for backups. You should also have an access key and secret key for a user that can read and write that bucket. For best results, create a dedicated bucket and dedicated credentials only for backups.

Step 1: Install Restic

On Ubuntu/Debian, install from the package repository:

sudo apt update && sudo apt install -y restic

On RHEL/AlmaLinux/Rocky, restic may be available via EPEL, or you can install from an official release binary. If you install a binary, place it in /usr/local/bin/restic and ensure it’s executable.

Step 2: Prepare Environment Variables for S3

Restic reads S3 settings from environment variables. Create a root-only file to store them:

sudo mkdir -p /etc/restic
sudo nano /etc/restic/env

Add values like the following (adjust to your provider). The AWS_ENDPOINT_URL line is especially important for S3-compatible services:

export AWS_ACCESS_KEY_ID="YOUR_ACCESS_KEY"
export AWS_SECRET_ACCESS_KEY="YOUR_SECRET_KEY"
export AWS_DEFAULT_REGION="us-east-1"
export AWS_ENDPOINT_URL="https://s3.your-provider.example"

Lock down permissions so only root can read it:

sudo chmod 600 /etc/restic/env

Step 3: Create and Initialize the Restic Repository

Decide where your repository will live. For S3, the syntax is s3:https://endpoint/bucketname or sometimes s3:bucketname depending on provider. A safe, explicit pattern for S3-compatible endpoints is:

export RESTIC_REPOSITORY="s3:https://s3.your-provider.example/my-linux-backups"

Set a strong repository password (store it securely). For unattended jobs, put it in a root-only file:

sudo nano /etc/restic/password

Add one line containing the password, then:

sudo chmod 600 /etc/restic/password

Initialize the repository:

sudo bash -c 'source /etc/restic/env && export RESTIC_PASSWORD_FILE=/etc/restic/password && export RESTIC_REPOSITORY="s3:https://s3.your-provider.example/my-linux-backups" && restic init'

Step 4: Run Your First Incremental Backup

Restic snapshots are incremental by design: after the first run, subsequent runs only transfer changed data. Start with a realistic set of folders. For a server, you might back up /etc, /home, and application data such as /srv. Avoid transient paths like /proc and /sys.

Example backup command:

sudo bash -c 'source /etc/restic/env && export RESTIC_PASSWORD_FILE=/etc/restic/password && export RESTIC_REPOSITORY="s3:https://s3.your-provider.example/my-linux-backups" && restic backup /etc /home /srv --exclude /home/*/.cache --exclude /srv/tmp'

List snapshots to confirm it worked:

sudo bash -c 'source /etc/restic/env && export RESTIC_PASSWORD_FILE=/etc/restic/password && export RESTIC_REPOSITORY="s3:https://s3.your-provider.example/my-linux-backups" && restic snapshots'

Step 5: Add Retention Rules (Forget + Prune)

Without retention, backups grow forever. A common policy is “keep daily backups for a week, weekly backups for a month, and monthly backups for a year.” Apply it like this:

sudo bash -c 'source /etc/restic/env && export RESTIC_PASSWORD_FILE=/etc/restic/password && export RESTIC_REPOSITORY="s3:https://s3.your-provider.example/my-linux-backups" && restic forget --keep-daily 7 --keep-weekly 4 --keep-monthly 12 --prune'

The --prune option actually removes unreferenced data, keeping storage costs under control.

Step 6: Automate Backups with a Systemd Service and Timer

Create a simple backup script so the systemd unit stays clean:

sudo nano /usr/local/sbin/restic-backup.sh

Paste (adjust paths and repository):

#!/bin/bash
set -euo pipefail
source /etc/restic/env
export RESTIC_PASSWORD_FILE=/etc/restic/password
export RESTIC_REPOSITORY="s3:https://s3.your-provider.example/my-linux-backups"
restic backup /etc /home /srv --exclude /home/*/.cache --exclude /srv/tmp
restic forget --keep-daily 7 --keep-weekly 4 --keep-monthly 12 --prune
restic check

Make it executable:

sudo chmod 700 /usr/local/sbin/restic-backup.sh

Now create the systemd service:

sudo nano /etc/systemd/system/restic-backup.service

Service content:

[Unit]
Description=Restic Backup to S3
Wants=network-online.target
After=network-online.target

[Service]
Type=oneshot
ExecStart=/usr/local/sbin/restic-backup.sh

Create the timer (daily at 02:15):

sudo nano /etc/systemd/system/restic-backup.timer

Timer content:

[Unit]
Description=Run Restic Backup Daily

[Timer]
OnCalendar=*-*-* 02:15:00
Persistent=true

[Install]
WantedBy=timers.target

Enable it:

sudo systemctl daemon-reload
sudo systemctl enable --now restic-backup.timer

Check status and recent runs:

systemctl status restic-backup.timer
journalctl -u restic-backup.service --since "2 days ago"

Step 7: Test a Restore (The Part Most People Skip)

A backup you never test is just a theory. Create a restore directory and restore a single file or folder to verify permissions and content:

sudo mkdir -p /restore-test
sudo bash -c 'source /etc/restic/env && export RESTIC_PASSWORD_FILE=/etc/restic/password && export RESTIC_REPOSITORY="s3:https://s3.your-provider.example/my-linux-backups" && restic restore latest --target /restore-test --include /etc/ssh'

Confirm the restored files exist under /restore-test. If you can restore cleanly, you can trust the automation far more.

Final Notes for a Reliable Backup Routine

For production systems, keep the repository password in a secure vault when possible, restrict bucket permissions, and consider enabling object-lock or versioning if your provider supports it. Restic’s encryption and incremental design make it efficient, but the real win is consistency: automated snapshots, retention rules, and periodic restore tests turn backups into a predictable safety net instead of a last-minute panic.

How to Set Up Restic + S3-Compatible Storage for Fast, Encrypted Linux Backups (With Automation and Restore Testing)

Why Restic Is a Smart Backup Tool in 2026

If you want a modern backup system on Linux that is fast, encrypted by default, and easy to automate, restic is one of the most practical options available today. It creates deduplicated snapshots, supports incremental backups automatically, and works with many backends including local disks, SSH, and S3-compatible object storage (Amazon S3, Backblaze B2 S3 API, MinIO, Wasabi, and more). In this tutorial, you will set up restic with an S3-compatible bucket, run your first backup, verify integrity, and automate daily runs with systemd.

What You Need Before You Start

You will need a Linux machine (server or workstation), an S3-compatible bucket, and access credentials (Access Key ID and Secret Access Key). Make sure the bucket exists and that your account has permission to list, write, and delete objects. Also plan a secure place for a restic password (a file readable only by root is typical). If you are backing up a server, decide which paths to include and which to exclude (temporary folders, caches, and large build artifacts).

Step 1: Install Restic

On Ubuntu/Debian, you can install from the repo, but for newer features you may prefer the official binary release. First try the package manager:

Debian/Ubuntu: sudo apt update && sudo apt install -y restic

RHEL/Fedora: sudo dnf install -y restic

Confirm the version with restic version. If your distro version is old and you need a newer build, download the official release from restic’s GitHub and place it in /usr/local/bin.

Step 2: Create a Secure Password File

Restic encrypts the repository using a password. Store it in a root-owned file and lock down permissions:

sudo mkdir -p /etc/restic
sudo bash -c 'umask 077; printf "%s\n" "REPLACE_WITH_A_LONG_RANDOM_PASSWORD" > /etc/restic/repo.pass'
sudo chmod 600 /etc/restic/repo.pass

Use a long random password. If you lose it, you lose access to the backup data.

Step 3: Export S3 and Restic Environment Variables

Restic reads configuration from environment variables. For an S3-compatible provider, you will typically set the endpoint URL too (MinIO, Wasabi, or private S3 gateways). Create a config file you can reuse for scripts:

sudo bash -c 'cat > /etc/restic/env.sh <<EOF export AWS_ACCESS_KEY_ID="YOUR_ACCESS_KEY" export AWS_SECRET_ACCESS_KEY="YOUR_SECRET_KEY" export RESTIC_PASSWORD_FILE="/etc/restic/repo.pass" export RESTIC_REPOSITORY="s3:https://s3.example.com/my-linux-backups" # Optional but common for S3-compatible services: export AWS_DEFAULT_REGION="us-east-1" EOF chmod 600 /etc/restic/env.sh'

Replace s3.example.com with your provider endpoint (or omit it for AWS), and use your bucket name in the repository path.

Step 4: Initialize the Backup Repository

Initialize the repo once. After that, all backups go into this encrypted repository:

sudo bash -c 'source /etc/restic/env.sh; restic init'

If you see an error about permissions or endpoint connectivity, confirm that the endpoint URL is correct and that your credentials can write to the bucket.

Step 5: Run Your First Backup (With Sensible Exclusions)

A good first backup for a Linux server is often /etc, home directories, and important app data. Exclude caches and ephemeral content to reduce cost and time:

sudo bash -c 'source /etc/restic/env.sh; restic backup /etc /home \ --exclude "/home/*/.cache" \ --exclude "/home/*/.local/share/Trash" \ --exclude "/var/tmp" \ --exclude "/tmp"'

Restic will create a snapshot ID. That snapshot is an immutable point-in-time view you can list and restore later.

Step 6: Verify Backups and Test Restore

A backup that has never been verified is not a backup. Start by listing snapshots:

sudo bash -c 'source /etc/restic/env.sh; restic snapshots'

Then run an integrity check occasionally (especially after large backups):

sudo bash -c 'source /etc/restic/env.sh; restic check'

Finally, do a small restore test to a temporary directory to confirm you can recover files:

sudo mkdir -p /root/restore-test
sudo bash -c 'source /etc/restic/env.sh; restic restore latest --target /root/restore-test --include "/etc/hostname"'

Open the restored file and confirm it matches the live system. This simple step catches password, permissions, and repository issues early.

Step 7: Automate Daily Backups with systemd

For reliable automation, systemd timers are cleaner than cron because they can track failures and integrate with logs. Create a backup script:

sudo bash -c 'cat > /usr/local/sbin/restic-backup.sh <<EOF #!/bin/bash set -euo pipefail source /etc/restic/env.sh restic backup /etc /home \ --exclude "/home/*/.cache" \ --exclude "/home/*/.local/share/Trash" \ --exclude "/tmp" --exclude "/var/tmp" # Keep policy: adjust to your needs and storage costs restic forget --keep-daily 7 --keep-weekly 4 --keep-monthly 6 --prune EOF chmod 700 /usr/local/sbin/restic-backup.sh'

Now create a systemd service and timer:

sudo bash -c 'cat > /etc/systemd/system/restic-backup.service <<EOF [Unit] Description=Restic backup to S3 [Service] Type=oneshot ExecStart=/usr/local/sbin/restic-backup.sh EOF'

sudo bash -c 'cat > /etc/systemd/system/restic-backup.timer <<EOF [Unit] Description=Run restic backup daily [Timer] OnCalendar=daily Persistent=true [Install] WantedBy=timers.target EOF'

Enable and start the timer:

sudo systemctl daemon-reload
sudo systemctl enable --now restic-backup.timer
systemctl list-timers | grep restic

Troubleshooting Tips

If backups fail with S3 errors, double-check the endpoint URL, DNS, firewall rules, and bucket permissions. If you see slow performance, consider placing the repository in a region closer to your server, and avoid backing up huge temporary directories. If pruning takes too long, run it weekly instead of daily, or prune during low-traffic hours. Most importantly, schedule a recurring restore test (monthly is a good baseline) so you know recovery is possible when you actually need it.

Wrap-Up

With restic and S3-compatible storage, you get encrypted, deduplicated backups that scale from a single VPS to multiple servers. The setup is lightweight, the restore process is straightforward, and automation with systemd makes it dependable. Once this is working, the next advanced step is to add monitoring (alert on failed timers) and document your restore procedure so anyone on your team can recover data under pressure.

3.

Popular Posts

Install Ollama and Open WebUI on Ubuntu 24.04 with NVIDIA GPU Acceleration (Step-by-Step)

Install Ollama + Open WebUI on Ubuntu 24.04 with NVIDIA GPU Acceleration (Step-by-Step)

Install a Local AI Chatbot on Ubuntu 24.04 with Ollama and Open WebUI (Step-by-Step)

Trending Now

Recovering from Btrfs Boot Failures Using GUI Tools on Fedora

By the end of this guide the reader will be able to identify a Btrfs‑based Fedora installation, boot from a live USB, list and restore snapshots using the graphical utilities btrfs‑assistant and snapper, and verify that the system returns to a functional state without resorting to the command line. Understanding the Btrfs Layout Used by Fedora Fedora Workstation and Fedora KDE install the root filesystem as a single Btrfs partition that contains two default sub‑volumes. One sub‑volume holds the traditional “/” hierarchy, while the second is dedicated to /var/lib/machines . The latter exists to keep container images out of snapshot operations; it remains empty on systems that do not run virtual machines. Because Btrfs stores data in sub‑volumes rather than separate partitions, a snapshot captures the state of an entire sub‑volume at a point in time. The installer (Anaconda) automatically registers these sub‑volumes with the snapper service. Snapper maintains a series of read‑only ...