Deploy and Host apoia on Railway

apoia is a self-hosted support page for Brazilian open source maintainers — a Buy Me a Coffee built around Pix. Supporters choose an amount, optionally leave a name and a message, and pay by Pix. No sign-up, no email, no CPF, no phone number is collected.

About Hosting apoia

apoia runs as a single container backed by SQLite on a mounted volume — no external database, cache, or queue to provision. Migrations run automatically on every boot, before the server accepts traffic, so upgrading is just a redeploy. You supply four environment variables: the public URL, a Woovi App ID for Pix, and the Google address plus a session secret for the admin. Everything else — your name, avatar, links, projects, suggested amounts, thank-you message — is configured through the admin UI after your first login, not through environment variables. One manual step remains after deploying: registering the Woovi webhook that confirms payments.

Common Use Cases

Accepting Pix contributions for an open source project you maintain, with a public timeline of supporters and their messages
Running a dedicated page per project (/your-project) with its own headline, all feeding one shared timeline
Offering a tip jar where supporters can stay anonymous in public while you still see who they were in the admin

Dependencies for apoia Hosting

A Woovi account — its App ID is what issues the Pix charges
A Google account for the admin login, brokered by shoo.dev
A persistent volume for the SQLite database

Implementation Details

Check GitHub repo: https://github.com/valtlfelipe/apoia

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