Deploy Wallos

Deploy and Host Wallos on Railway

Wallos is an open-source, self-hosted subscription and recurring-expense tracker. It helps individuals and households organize subscriptions, payment dates, categories, currencies, budgets, logos, dashboards, and notifications while keeping financial data on infrastructure they control.

About Hosting Wallos

Hosting Wallos on Railway means running one public, digest-pinned container with persistent storage for its SQLite database and uploaded subscription logos. The service listens on container port 80, uses Railway's generated HTTPS domain, and checks / for health. The template supplies UTC and Linux ownership defaults (TZ=Etc/UTC, PUID=1000, and PGID=1000) so the upstream image starts without credentials or an external database. Users complete Wallos's first-run account setup in the browser and configure optional integrations, such as exchange-rate, notification, or OIDC providers, inside Wallos when needed.

Common Use Cases

• Tracking household or personal recurring subscriptions and upcoming payments
• Reviewing spending by category, currency, payment method, dashboard, and calendar
• Running a private self-hosted finance tool with optional notifications and logo search

Dependencies for Wallos Hosting

• One public Railway service running the immutable Wallos 5.4.2 image
• Persistent storage for /var/www/html/db and /var/www/html/images/uploads/logos
• No external database, cache, or credential is required for the baseline deployment

Deployment Dependencies

• Wallos v5.4.2 release
• Wallos upstream repository and Docker installation guide
• Wallos Docker image
• Umbrel Wallos package contract

Implementation Details

The image's upstream startup process initializes or migrates the SQLite database and starts PHP-FPM, cron, and nginx. Railway runs the service with ON_FAILURE restart handling and ten retries. The template's safe variables are PORT=80, TZ=Etc/UTC, PUID=1000, and PGID=1000; no source-project credentials are copied into the template.

Why Deploy Wallos 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 Wallos 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.