Deploy OpenTodo
Free, open-source to-do app you run on your own server.
opentodoapp/opentodo:stable
Just deployed
/data
Deploy and Host OpenTodo on Railway
OpenTodo is an open-source, local-first task manager. It replaces subscription task apps with one small container you own: the web app, the sync server and the database (SQLite) in a single image. Every device keeps a full copy, works offline and syncs when it is back.
About Hosting OpenTodo
This template runs the released OpenTodo image as one service with a volume on /data, where the database, attachments and backups live. Railway gives it an https address, which becomes OPENTODO_BASE_URL so passkeys, secure cookies and links work. The first person to open the address creates the owner account; the template generates a setup token for it, which you find in the service's Variables tab. Sign-up stays closed: the owner invites people.
If the first deploy fails with "OPENTODO_BASE_URL must be an absolute URL", the service has no public domain yet. Open the service's Settings, go to Networking, click Generate Domain with port 8080, then redeploy.
Common Use Cases
- Personal tasks, projects and notes on every device, without a subscription
- A small team or family sharing projects on a server they control
- Replacing Todoist or TickTick with an open-source app, with import
- Planning the day in a calendar view, with reminders as push notifications
Dependencies for OpenTodo Hosting
- None besides the OpenTodo image: the database is SQLite on the volume
Deployment Dependencies
- Image: https://github.com/OpenTodoApp/OpenTodo/pkgs/container/opentodo
- Source and documentation: https://github.com/OpenTodoApp/OpenTodo
Implementation Details
One service from the image ghcr.io/opentodoapp/opentodo:stable, one replica, a volume mounted on /data, health check on /healthz, and a public domain on port 8080, which OPENTODO_BASE_URL needs.
| Variable | Value | Description |
|---|---|---|
OPENTODO_BASE_URL | https://${{RAILWAY_PUBLIC_DOMAIN}} | The address people open. Passkeys, secure cookies and links in emails use it. Change it if you add a custom domain. |
OPENTODO_SETUP_TOKEN | ${{secret(32)}} | Asked once, when you create the owner account. Find it in this service's Variables tab. |
OPENTODO_ALLOW_SIGNUP | false | true lets anyone who can reach the address create an account. Otherwise the owner invites people. |
OPENTODO_TRUSTED_PROXIES | (empty) | Leave empty on Railway: its edge proxy is the only hop. |
PORT | 8080 | The port OpenTodo listens on; Railway routes and health-checks it. Do not change it. |
RAILWAY_RUN_UID | 0 | Lets OpenTodo write to the volume: the image runs as a non-root user, and Railway's volumes are writable by root. |
Why Deploy OpenTodo 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 OpenTodo 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
opentodoapp/opentodo:stable
ghcr.io/opentodoapp/opentodo:stable