Deploy Zerobyte
Restic backup automation with a web UI: schedules, retention and restores
Just deployed
/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/zerobyteimage, pinned by digest), with restic 0.19.1, rclone 1.75.2 and its built-in SQLite database - A Railway volume at
/var/lib/zerobytefor the database, restic password, cache and local repositories
Deployment Dependencies
- Zerobyte on GitHub and its v0.44.2 release
- Zerobyte documentation (configuration, repositories, remote agents, rclone)
- Template repository (Dockerfile, start script, changelog)
Implementation Details
There is nothing to fill in. After the deploy finishes:
- Open your Railway URL straight away: the first visitor creates the admin account, and sign-up then closes.
- 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.
- 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
