---
title: "Deploy apoia"
description: "Page to receive Pix support for your work, inspired by Buy Me a Coffee"
category: "Other"
url: https://railway.com/deploy/apoia
---

# Deploy apoia

Page to receive Pix support for your work, inspired by Buy Me a Coffee

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

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

- **Creator:** FVM
- **Category:** Other

## Template content

### valtlfelipe/apoia:latest https://cdn.statically.io/gh/valtlfelipe/apoia@main/docs/images/icon.png

- **Image:** ghcr.io/valtlfelipe/apoia:latest
- **Health check:** /api/health
- **Public domain:** Yes

## Documentation

# 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](https://woovi.com) account — its App ID is what issues the Pix charges
- A Google account for the admin login, brokered by [shoo.dev](https://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.

## 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) — A Self-Hosted & Modern Roleplaying Platform
- [Letta Code Remote](https://railway.com/deploy/letta-code-remote) — Run a Letta Code agent 24/7. No inbound ports, just deploy.

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