Docs / Backup & Recovery / How to Set Up Kopia Backup Tool

How to Set Up Kopia Backup Tool

By Admin · Mar 1, 2026 · Updated Apr 23, 2026 · 32 views · 2 min read

What Is Kopia?

Kopia is a fast, secure, open-source backup tool that supports encrypted, compressed, and deduplicated snapshots to local, cloud, and remote storage. It features a web UI, CLI, and policy-based scheduling, making it a modern alternative for backing up your Breeze.

Prerequisites

  • A Breeze running Ubuntu 22.04 or later
  • Root or sudo access

Install Kopia

curl -s https://kopia.io/signing-key | gpg --dearmor | sudo tee /usr/share/keyrings/kopia-keyring.gpg > /dev/null
echo "deb [signed-by=/usr/share/keyrings/kopia-keyring.gpg] https://packages.kopia.io/apt/ stable main" | sudo tee /etc/apt/sources.list.d/kopia.list
sudo apt update && sudo apt install -y kopia

Create a Repository

Initialize a local repository:

kopia repository create filesystem --path /backup/kopia-repo

Or connect to S3-compatible storage:

kopia repository create s3 --bucket=my-backup-bucket --access-key=YOUR_KEY --secret-access-key=YOUR_SECRET --endpoint=s3.amazonaws.com

Create Snapshots

kopia snapshot create /var/www
kopia snapshot create /etc
kopia snapshot create /home

Set Scheduling Policies

kopia policy set /var/www --keep-daily 7 --keep-weekly 4 --keep-monthly 6
kopia policy set /var/www --scheduling-interval-hours 6

Restore Files

List available snapshots and restore:

kopia snapshot list /var/www
kopia restore <snapshot-id> /tmp/restore-target

Enable the Web UI

kopia server start --address=0.0.0.0:51515 --insecure

For production, use --tls-cert-file and --tls-key-file flags, or bind to localhost and access through an SSH tunnel.

Was this article helpful?