Overview

Backrest is a web-accessible backup solution built on top of restic. Backrest provides a WebUI which wraps the restic CLI and makes it easy to create repos, browse snapshots, and restore files. Additionally, Backrest can run in the background and take an opinionated approach to scheduling snapshots and orchestrating repo health operations.

By building on restic, Backrest leverages its mature, fast, reliable, and secure backup capabilities while adding an intuitive interface.

Built with Go, Backrest is distributed as a standalone, lightweight binary with restic as its sole dependency. It can securely create new repositories or manage existing ones. Once storage is configured, the WebUI handles most operations, while still allowing direct access to the powerful restic CLI for advanced operations when needed.

• Web Interface: Access locally or remotely (perfect for NAS deployments)
• Multi-Platform Support:
  • Linux
  • macOS
  • Windows
  • FreeBSD
  • Docker
• Backup Management:
  • Import existing restic repositories
  • Cron-scheduled backups and maintenance (e.g. prune, check, forget, etc)
  • Browse and restore files from snapshots
  • Configurable notifications (Discord, Slack, Shoutrrr, Gotify, Healthchecks)
  • Pre/post backup command hooks to execute shell scripts
• Storage Options:
  • Compatible with rclone remotes
  • Supports all restic storage backends (S3, B2, Azure, GCS, local, SFTP, and all rclone remotes)

See the Backrest docs.

Backrest is packaged as a single executable. It runs directly on Linux, macOS, and Windows. restic is downloaded automatically on first run.

Once installed, access Backrest at http://localhost:9898 (default port). First-time setup will prompt for username and password creation.

The install script downloads the latest release, drops the binary into /usr/local/bin, and sets up the appropriate auto-start integration (systemd or OpenRC on Linux; launchd on macOS):

curl -fsSL https://raw.githubusercontent.com/garethgeorge/backrest/main/install.sh | bash

Flags go after --:

# Bind to all interfaces (default: 127.0.0.1:9898)
curl -fsSL https://raw.githubusercontent.com/garethgeorge/backrest/main/install.sh | bash -s -- --allow-remote-access

# Uninstall (removes service, autostart entry, and /usr/local/bin/backrest)
curl -fsSL https://raw.githubusercontent.com/garethgeorge/backrest/main/install.sh | bash -s -- --uninstall

The service runs as your user by default (so config and data live under your $HOME). To install as root instead, pass --root. After install, access Backrest at http://localhost:9898.

Homebrew tap:

brew tap garethgeorge/homebrew-backrest-tap
brew install backrest
brew services start backrest

Backrest on AUR is third-party (not maintained by the Backrest project) and tweaks the systemd unit; see the AUR service file for details.

paru -Sy backrest  # or: yay -Sy backrest
sudo systemctl enable --now backrest@$USER.service

Image: ghcr.io/garethgeorge/backrest (also on Docker Hub).

• Includes rclone and common Unix utilities
• For a minimal image, use ghcr.io/garethgeorge/backrest:scratch

version: "3.8"
services:
  backrest:
    image: ghcr.io/garethgeorge/backrest:latest
    container_name: backrest
    hostname: backrest
    volumes:
      - ./backrest/data:/data
      - ./backrest/config:/config
      - ./backrest/cache:/cache
      - ./backrest/tmp:/tmp
      - ./backrest/rclone:/root/.config/rclone # Mount for rclone config (needed when using rclone remotes)
      - /path/to/backup/data:/userdata  # Mount local paths to backup
      - /path/to/local/repos:/repos     # Mount local repos (optional for remote storage)
    environment:
      - BACKREST_DATA=/data
      - BACKREST_CONFIG=/config/config.json
      - XDG_CACHE_HOME=/cache
      - TMPDIR=/tmp
      - TZ=America/Los_Angeles
    ports:
      - "9898:9898"
    restart: unless-stopped

Download the Windows installer for your architecture from the releases page. The installer, named Backrest-setup-[arch].exe, places Backrest and a GUI tray application in %localappdata%\Programs\Backrest\. The tray application, set to start on login, monitors Backrest.

Contributions are welcome! See the issues or feel free to open a new issue to discuss a project. Beyond the core codebase, contributions to documentation, cookbooks, and testing are always welcome.

All build dependencies are defined in shell.nix and can be activated automatically using Nix and direnv.

1. Install Nix and direnv
2. Hook direnv into your shell (e.g. eval "$(direnv hook bash)" in your .bashrc)
3. Clone the repo and cd into it
4. Run direnv allow to trust the .envrc — all dependencies (Go, Node.js, pnpm, protoc, buf, etc.) will be available in your shell automatically

If you prefer not to use Nix, install the following manually:

• Go 1.24 or greater
• Node.js 20.x and pnpm 9
• goreleaser go install github.com/goreleaser/goreleaser/v2@latest

(Optional) To edit protobuf definitions:

apt install -y protobuf-compiler
go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest
go install github.com/bufbuild/buf/cmd/buf@latest
go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
go install connectrpc.com/connect/cmd/protoc-gen-connect-go@latest
npm install -g @bufbuild/protoc-gen-es

(cd webui && pnpm i && pnpm run build)
(cd cmd/backrest && go build .)

日常开发时，把后端和前端作为两个独立进程分别启动。Vite 开发服务器以热模块替换（HMR）的方式提供 WebUI，并把 API 请求代理到后端，因此前端改动会立即生效，无需重新构建。

1. 先启动前端（Vite 开发服务器，地址 http://localhost:5173）：

cd webui
pnpm i           # 仅首次需要
pnpm start       # 将 /v1 及 API 请求代理到 http://localhost:9898

2. 再运行后端（在 127.0.0.1:9898 上提供 API）：

如果没有安装air的话，需要先安装

go install github.com/air-verse/air@latest

运行项目：

cd cmd/backrest && BACKREST_DATA=/tmp/backrest-dev/data && BACKREST_CONFIG=/tmp/backrest-dev/config.json && air

然后打开 **http://localhost:5173**（不是 :9898）。首次运行时会自动把 restic 二进制下载到 data 目录中。

注意事项：

• 前端（webui/src）改动会自动热重载，无需手动刷新。
• 后端 Go 代码改动需要重启 go run . 进程（后端不支持热重载）。
• 修改 proto/ 下的 protobuf 定义后，需要重新生成共享绑定代码（前端和后端都依赖 gen/）：

buf generate

The dev container uses Nix and direnv to provide all dependencies. When the container starts, direnv allow runs automatically so the Nix shell is activated in every terminal.

0. Make sure Docker and VSCode with the Dev Containers extension is installed
1. Clone this repository
2. Open this folder in VSCode
3. When prompted, click on Open in Container button, or run > Dev Containers: Rebuild and Reopen in Containers command
4. When the container is started, go to Run and Debug, choose Debug Backrest (backend+frontend) and run it

Translations are stored in ./webui/messages and are generated using inlang. Machine translations can be updated by running npx @inlang/cli machine translate --project ./project.inlang.

Text is translated on a best-effort basis and is not guaranteed to be accurate. If you find any translations that are incorrect, please submit a pull request to fix them. Contributions here are greatly appreciated!