Deploy Zerobyte

Restic backup automation with a web UI: schedules, retention and restores

Deploy Zerobyte

/var/lib/zerobyte

Deploy and Host Zerobyte on Railway

Zerobyte is an open-source backup automation tool built on restic. Its web interface lets you schedule encrypted, compressed and deduplicated backups, set retention policies, browse snapshots, restore files and get notified when a job fails. Backups go to S3-compatible storage, Google Cloud Storage, Azure, SFTP, REST servers or rclone remotes.

About Hosting Zerobyte

Zerobyte is a single Bun server that serves the web UI and API on one port and runs restic, rclone and Shoutrrr inside the same container. It keeps its state on disk: a SQLite database, the restic password, the restic cache and any local repositories. Hosting it means running the official image behind HTTPS, keeping that folder on a persistent volume and setting a stable encryption secret. This template builds Zerobyte v0.44.2 from a pinned official image, puts all state on one Railway volume, generates the secret, trusts Railway's HTTPS proxy and enables remote agents. Railway containers can't mount NFS, SMB, WebDAV or SFTP shares, so other machines are backed up through Zerobyte's remote agents.

Common Use Cases

  • Schedule encrypted restic backups of your servers to S3, Backblaze B2, Cloudflare R2 or another cloud bucket
  • Manage backup jobs, retention and restores for several machines from one dashboard, using remote agents
  • Get notified by Slack, Discord, ntfy, email or webhooks when a backup fails

Dependencies for Zerobyte Hosting

  • Zerobyte v0.44.2 (official ghcr.io/nicotsx/zerobyte image, pinned by digest), with restic 0.19.1, rclone 1.75.2 and its built-in SQLite database
  • A Railway volume at /var/lib/zerobyte for the database, restic password, cache and local repositories

Deployment Dependencies

Implementation Details

There is nothing to fill in. After the deploy finishes:

  1. Open your Railway URL straight away: the first visitor creates the admin account, and sign-up then closes.
  2. Download the recovery key when asked and store it safely. It holds the restic password; without it your backups can't be read if the server is lost.
  3. Add a repository (where backups go), then a source and a backup schedule.

What you can back up from Railway: Railway gives containers no SYS_ADMIN capability or /dev/fuse, so NFS, SMB, WebDAV, SFTP and rclone sources can't be mounted here. Use Settings > Machines > Connect machine instead: it gives a one-time install command or a Docker Compose snippet for ghcr.io/nicotsx/zerobyte-agent (use v0.44.2). The agent runs on the machine you want to back up, connects out to your Railway URL, and sends backups straight to your repository. Upstream still marks remote agents as new, and agent sources can't use local or rclone repositories. Directory sources inside the container also work.

APP_SECRET encrypts stored credentials, so keep it. If you add a custom domain, set BASE_URL to https://YOUR-DOMAIN. TZ sets the time zone for schedules. Optional settings (TRUSTED_ORIGINS, WEBHOOK_ALLOWED_ORIGINS, GOMAXPROCS, OIDC single sign-on, notifications) are covered in Zerobyte's configuration docs. For rclone repositories, put rclone.conf in /var/lib/zerobyte/rclone.

Updates: the service builds from aalfath/zerobyte-railway-template. When a new Zerobyte release is pinned there, Railway shows an update notice on your project and you choose when to apply it. Zerobyte is still 0.x, so read the changelog first; your data stays on the volume.

Why Deploy Zerobyte on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying Zerobyte on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.


Template Content

More templates in this category

View Template
RustFS | (Just Updated) S3 Object Store, Public URL and Keys Set
S3-compatible object store, keys and public URL preset, volume kept

SuperSlowSloth
0
View Template
TimescaleDB
A PostgreSQL-based time-series database for analytics on Railway.

Rakit
1
View Template
Neo4j 2026.10 Community
Neo4j graph database with APOC, Browser, Bolt TCP proxy and a volume

My Projects
0