Restora is a WebUI wrapper for restic. It is intended to be used as a self-hosted application for managing backups of your data.

The goals of this project are:

• Full featured web UI for restic: supports all basic operations (e.g. backup, restore, browse snapshots, prune old data, etc).
• Interactive: UI is fast and responds to operation progress in real time (e.g. backups show live progress bars).
• Safe: all backups leverage simple restic features and have test coverage.
• Easy to pull back the curtain: all common operations should be possible from the UI, but it should be easy to drop down to the command line and use restic directly if needed.
• Lightweight: your backup orchestration should blend into the background. The web UI binary is fully self contained as a single executable and the binary is <20 MB with very light memory overhead at runtime.

OS Support

• Linux
• MacOS (Darwin)
• Windows (note: must be run as administrator on first execution to install the restic binary in Program Files).

Installation options

• Download and run a release from the releases page.
• Build from source (see below).
• Run with docker: garethgeorge/restora:latest (see on dockerhub)

Restora is accessible from a web browser. By default it binds to 0.0.0.0:9898 and can be accessed at http://localhost:9898.

• RESTORA_PORT - the port to bind to. Defaults to 9898.
• RESTORA_CONFIG_PATH - the path to the config file. Defaults to $HOME/.config/restora/config.json or if $XDG_CONFIG_HOME is set, $XDG_CONFIG_HOME/restora/config.json.
• RESTORA_DATA_DIR - the path to the data directory. Defaults to $HOME/.local/share/restora or if $XDG_DATA_HOME is set, $XDG_DATA_HOME/restora.
• RESTORA_RESTIC_BIN_PATH - the path to the restic binary. Defaults managed version of restic which will be downloaded and installed in the data directory.
• XDG_CACHE_HOME -- the path to the cache directory. This is propagated to restic.

ResticWeb is shipped today as a standalone executable, in future releases we'll provide system service installation for common operating systems.

sudo mv restora /usr/local/bin/restora

@reboot /usr/local/bin/restora

sudo mv restora /usr/local/bin/restora

[Unit]
Description=ResticWeb
After=network.target

[Service]
Type=simple
User=<your linux user>
Group=<your linux group>
ExecStart=/usr/local/bin/restora

[Install]
WantedBy=multi-user.target

sudo systemctl enable restora
sudo systemctl start restora

Build Dependencies

• Node.JS for UI development
• Go 1.21 or greater for server development
• go.rice go install github.com/GeertJohan/go.rice@latest and go install github.com/GeertJohan/go.rice/rice@latest

To Edit Protobuffers

apt install -y protobuf-compiler
go install \
    github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-grpc-gateway@latest \
    github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-openapiv2@latest
go install github.com/grpc-ecosystem/protoc-gen-grpc-gateway-ts@latest
go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest
go install github.com/bufbuild/buf/cmd/buf@v1.27.2

(cd webui && npm i && npm run build)
(cd cmd/restora && go build .)