---
title: "Deploy OpenTodo"
description: "Free, open-source to-do app you run on your own server."
category: "Other"
url: https://railway.com/deploy/opentodo
---

# Deploy OpenTodo

Free, open-source to-do app you run on your own server.

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

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

- **Creator:** OpenTodo
- **Category:** Other
- **Total deploys:** 1

## Template content

### opentodoapp/opentodo:stable

- **Image:** ghcr.io/opentodoapp/opentodo:stable
- **Health check:** /healthz

## Documentation

# 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.

## 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)
- [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/opentodo
