---
title: "Deploy Budgero"
description: "Zero-based budgeting app with end-to-end encryption and offline use"
category: "Other"
url: https://railway.com/deploy/budgero
---

# Deploy Budgero

Zero-based budgeting app with end-to-end encryption and offline use

**[Deploy Budgero on Railway](https://railway.com/template/budgero)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/budgero/manifest.json

- **Creator:** tombadilo-bombadilo's Projects
- **Category:** Other

## Template content

### budgero/budgero:v1.21.5 https://budgero.app/logo_512.png

- **Image:** budgero/budgero:latest
- **Health check:** /api/v1/health
- **Public domain:** Yes

## Documentation

# Deploy and Host Budgero on Railway

Budgero is a zero-based budgeting app: you give every dollar a job before you spend it. Budgets are encrypted in your browser before they reach the server, so the server stores data it can't read. It works offline, supports multiple currencies, and imports from YNAB and CSV.

## About Hosting Budgero

Budgero is a single Go binary with the web app built in, and it stores everything in SQLite on one volume. This template runs the official `budgero/budgero` image with a volume at `/data`, a public HTTPS domain, and a health check.

## Getting Started

1. Deploy the template and wait for the health check to pass.
2. Open the deploy logs and copy the admin password. It is printed once, on first start, and never again.
3. Open your Railway domain and log in as `admin`.
4. Create your budget and set a master password. It encrypts your data in the browser, and nobody can recover it if you lose it, including the server.
5. Using a custom domain? Add it to `WEBSOCKET_ALLOWED_ORIGINS` (comma-separated) and redeploy.

## Common Use Cases

- Running your own budget server instead of paying monthly for YNAB or another hosted budgeting app
- Sharing one budget with a partner or family, each with their own login
- Keeping financial data on infrastructure you control, encrypted end to end

## Dependencies for Budgero Hosting

- A Railway volume mounted at `/data` (SQLite database and encrypted budget files)
- Nothing else: no external database, cache or email service

### Implementation Details

Variables set by the template:

- `PORT=3001`: the port Budgero listens on
- `WEBSOCKET_ALLOWED_ORIGINS=https://${{RAILWAY_PUBLIC_DOMAIN}}`: the web addresses allowed to sync. If you add a custom domain, append it comma-separated, e.g. `https://${{RAILWAY_PUBLIC_DOMAIN}},https://budget.example.com`
- `SELF_HOST_JWT_SECRET`: random 64-character key, generated once at deploy, so logins survive redeploys
- `RAILWAY_RUN_UID=0`: lets the container write to the Railway volume

Budgero needs HTTPS in the browser (it uses the browser's encryption features), which Railway domains provide. Run a single replica, since the data lives on one volume. Admin settings and user management are at `/admin`, where you can add more users.

The template uses the `latest` image tag. To get new releases automatically, turn on image auto-updates in the service settings.

Docs: https://budgero.app/docs/self-hosting-guide
Source: https://github.com/tombadilo-bombadilo/budgero

## Why Deploy Budgero 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 Budgero 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.


## Similar templates

- [Rocky Linux](https://railway.com/deploy/rocky-linux) — Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀
- [Foundry Virtual Tabletop](https://railway.com/deploy/X5tR6G) — Self-hosted virtual tabletop for role-playing games (license required)
- [Double Commander in your browser](https://railway.com/deploy/double-commander-in-your-browser) — The Double Commander file manager in the cloud, from any device

Open this page in a browser: https://railway.com/deploy/budgero
