Skip to main content

kopia

kopia is a modern, deduplicating backup tool with both CLI and GUI. It supports S3-compatible storage as a repository.

Install​

PlatformCommand
macOSbrew install kopia
LinuxInstall from kopia.io/docs/installation/
WindowsDownload installer from kopia.io

Create a repository​

kopia repository create s3 \
  --bucket my-kopia-bucket \
  --endpoint s3.filebase.io \
  --access-key YOUR_FILEBASE_KEY \
  --secret-access-key YOUR_FILEBASE_SECRET \
  --region auto

You'll be prompted for a repository password — used to derive the client-side encryption key.

Connect to an existing repository​

On another machine, connect to the repository you already created:

kopia repository connect s3 \
  --bucket my-kopia-bucket \
  --endpoint s3.filebase.io \
  --access-key YOUR_FILEBASE_KEY \
  --secret-access-key YOUR_FILEBASE_SECRET \
  --region auto

Take a snapshot​

kopia snapshot create ~/Documents

kopia deduplicates and compresses on the fly — incremental snapshots add only new content.

List snapshots​

kopia snapshot list

Restore​

kopia snapshot restore <snapshot-id> ./restored-dir

Set retention policy​

kopia policy set --keep-latest 10 --keep-daily 30 --keep-monthly 12 ~/Documents

Mount a snapshot as read-only​

mkdir -p /mnt/snapshot
kopia mount <snapshot-id> /mnt/snapshot

Useful for browsing or selectively restoring files.

Server mode​

For backing up multiple machines to the same Filebase repository, run kopia in server mode:

kopia server start --address=0.0.0.0:51515 --tls-generate-cert

Clients then kopia repository connect from-config to talk to the server, which mediates access to Filebase.

What's next​