OpenTodo is a free, open source project & work management project written in TypeScript and released under AGPL-3.0. It has 546 GitHub stars, 55 forks and 81 open issues, and was last pushed 4 hours ago. On this registry it ranks #69 of 75 tracked projects in Project & Work Management, with 5 head-to-head comparisons available.

What is OpenTodo?

OpenTodo is an open-source, local-first task manager for individuals, families and small teams who want to run their own to-do lists, projects and daily planning on a server they control — or on a hosted instance — instead of renting them from a commercial app.

What it is

OpenTodo is a self-hosted task and project manager in the Business Software / Project & Work Management category, released under the AGPL-3.0 licence. It is written primarily in TypeScript, with React and Go among its listed topics, and ships as a progressive web app alongside native iPhone, iPad and Android clients. It covers the ground a commercial task app normally covers: capture, daily planning, focus timers and shared projects.

The concrete problem it addresses is ownership. In commercial task apps of the kind it replaces — Todoist, TickTick, Things — the list lives in the vendor's cloud and the price recurs. OpenTodo keeps everything in one folder on the operator's server, exportable at any time and importable elsewhere, with backups that can be scheduled to disk, S3 or WebDAV and encrypted if desired. With end-to-end encryption turned on, the server holds only ciphertext.

Key capabilities

  • Quick add parses natural-language input, so typing Call Sarah next Wed 3pm #work p1 sets the due date, time, project and priority in one line; tasks also arrive by dictation, the phone share sheet, the Chrome or Firefox capture extension, or a forwarded email, and anything unassigned lands in the Inbox.
  • Time blocking lets a task be given an estimate and dragged onto a Day or Week calendar, while the Today view shows what is due plus what is still open from earlier days.
  • Focus mode runs a Pomodoro, Flowtime or countdown timer against a single open task and logs the elapsed time to that task.
  • Shared projects support viewer, editor and admin roles, with task assignment, comments and a record of what changed, and every member can keep editing offline.
  • Offline-first sync keeps a full copy on each phone and computer, so the app works with no connection and catches up when one returns.
  • Import covers Todoist, TickTick, Things, Super Productivity, Microsoft To Do, Apple Reminders and more, with a preview and undo before anything is committed.
  • Privacy controls mean no telemetry, no analytics and no third-party scripts, plus an optional in-app AI assistant that is off by default and whose changes can be undone.

Who uses it and how

  • Individuals running a GTD-style workflow who want inbox capture, a daily plan and time blocking without a recurring fee.
  • Families sharing a household project, with members given viewer, editor or admin rights over the same list.
  • Small teams that need shared projects, task assignment and change history but cannot send task data to a third-party SaaS vendor.
  • Self-hosters deploying through Docker, Kubernetes with Helm, Unraid, the Home Assistant add-on or a single binary, or choosing the hosted PikaPods option if they would rather not run a server at all.
  • Privacy-conscious operators who enable end-to-end encryption so the hosting machine stores only ciphertext.

Getting started

The documented routes are a Docker deployment or a single binary, with Helm, Unraid and Home Assistant deployment paths alongside them, and PikaPods offering a hosted instance that needs no server. Clients are the installable web app, the iPhone and iPad app from the App Store, and an Android APK distributed from GitHub.

How it compares

Against Todoist and TickTick, which are proprietary and offer free plans with limits, and Things, which is a one-time purchase per device type, OpenTodo is open source, self-hostable and free with every feature and no subscription. Super Productivity matches it on licence, self-hosting and cost, but the project's own comparison marks shared projects as unsupported there, while OpenTodo provides roles, assignment and comments. The claimed differentiators are therefore self-hosting, data ownership, optional end-to-end encryption and multi-user sharing at no cost.

When to use it — and when not to

Choose it if you are willing to operate a server, look after the data folder and configure backups to disk, S3 or WebDAV, and if you value data ownership over a managed service. Avoid it if you need a polished mobile client on every store today: the iOS app is described as a first release with rough edges, Android is APK-only while Google Play and F-Droid are listed as coming soon, and Umbrel support is not yet available. Anyone who wants to take on no operational responsibility at all is better served by a commercial product.

project readme (upstream, from github) — read inline

OpenTodo

Plan your day without renting your to-do list.

OpenTodo is a free, open-source to-do app you run on your own server or have hosted for you. It works on your phone and your computer, even offline, shares lists with your family or your team, and keeps your data with you.

Try the demo · Install · Docs · Website

License: AGPL-3.0 CI Latest release Buy me a coffee Sponsor on GitHub Discord

New: OpenTodo for iPhone and iPad is in the App Store. It's the first release, a first step: it connects to your OpenTodo server and adds reminders on the phone, the share sheet, a Today widget and Face ID unlock. Expect some rough edges; tell us what to improve.

Ways to run it: PikaPods (hosted, no server needed) · Docker · Umbrel (coming soon) · Unraid · Home Assistant · Kubernetes (Helm) · Single binary · iPhone and iPad app (App Store) · Android app (APK from GitHub; Google Play and F-Droid coming soon) · all 20 platforms

How it works

1. Capture

Type a task the way you say it: Call Sarah next Wed 3pm #work p1 sets the date, time, project and priority. Dictate it, send a page from your phone's share menu or the browser extension (Chrome, Firefox), or forward an email. Anything without a home lands in the Inbox. Quick add · Voice · Capture

2. Plan your day

Today shows what is due and what is still open from earlier. Give tasks an estimate and drag them onto the Day or Week calendar to see whether the day fits. Today · Time blocking

3. Focus

Open one task in Focus and start a Pomodoro, Flowtime or countdown timer. The time is logged to the task. Focus

4. Share

Share a project with your family or your team as viewer, editor or admin. Assign tasks, comment, and see what changed. Everyone can edit offline. Sharing

Highlights

  • Your data stays yours. Everything lives in one folder on your server. Export it at any time, import it anywhere, and schedule backups, encrypted if you like, to disk, S3 or WebDAV. Backups · Import and export
  • Works offline on every device. Each phone and computer keeps a full copy, so the app works with no connection and syncs when it's back. Install the app
  • Bring your tasks. Import from Todoist, TickTick, Things, Super Productivity, Microsoft To Do, Apple Reminders and more, with a preview and undo. Import
  • Private by design. No telemetry, no analytics, no third-party scripts. Turn on end-to-end encryption and the server holds only ciphertext. Privacy · Encryption
  • Bring your own AI, if you want it. Talk to an assistant in the app, or connect the one you already use. Off by default, and every change can be undone. AI

No subscription, no lock-in, no tracking.

Explore all features →

How it compares

OpenTodo Todoist TickTick Things Super Productivity
Open source ✅ ❌ ❌ ❌ ✅
You can host it yourself ✅ ❌ ❌ ❌ ✅
Works offline ✅ ✅ ⚠️ ✅ ✅
Free, with every feature ✅ ❌ ❌ ❌ ✅
No subscription ✅ ❌ ❌ ✅ ✅
Optional end-to-end encryption ✅ ❌ ❌ ❌ ✅
Shared projects ✅ ✅ ✅ ❌ ❌

✅ yes · ❌ no · ⚠️ partly, or not documented. Todoist and TickTick have a free plan with limits; Things is a one-time purchase per device type. Based on each product's public information as of November 2026. If an entry is wrong, open an issue with a source.

Full comparisons →

Install

Try it in 30 seconds

  • No install: open the demo and press Try the demo. You get a private copy with sample data, deleted after a few hours.

  • On your machine or server:

    docker run -d -p 8080:8080 -v opentodo-data:/data ghcr.io/opentodoapp/opentodo:stable
    

    Open . The first visit creates your account. No configuration needed.

Docker Compose

git clone https://github.com/OpenTodoApp/OpenTodo.git
cd OpenTodo
docker compose up -d

Data is kept in the opentodo-data volume. On a server reachable from the internet, finish setup right after starting it, or set OPENTODO_SETUP_CODE=required (the setup code). Behind a reverse proxy, set OPENTODO_BASE_URL=https://todo.example.com.

The image is published for linux/amd64 and linux/arm64. :stable is the latest release, :1 follows every 1.x release, a minor tag such as :1.5 gets that line's fixes only, a full version such as :1.5.0 pins one release, and :latest follows the main branch. Upgrades from any release since 0.1.0 work directly, and nothing you rely on breaks within 1.x (stability). More in Running with Docker.

Single binary

Download opentodo-- for Linux, macOS or Windows from the latest release and run it. It serves on port 8080 and keeps its data in ./data. To build from source: make build && ./bin/opentodo (Go 1.26+ and Node 22+).

Managed hosting: PikaPods, Railway. These links support the project: OpenTodo receives a share when you host through them.

Configuration

Nothing is required. Every setting is an optional environment variable with a safe default: see the configuration reference. To add people, keep sign-up closed and send invitation links (managing users).

The self-hosting handbook covers every platform, TLS, backups, upgrades and monitoring. The ot command-line client is in the CLI guide.

Privacy

The app talks only to your own server: no analytics, crash reporters, update pings or third-party fonts. Two things are on by default and can be turned off: maps for task locations, fetched through your server with no account data, and web push to the service each phone's browser chose. Everything else the server contacts, such as webhooks, backup destinations, single sign-on, email or an AI provider, is something you set up. The audit log never records task content (what is logged).

Documentation

Read the docs with screenshots and search at open-todo.app/docs, or in the app under Help. The same pages are in docs/.

Build your own client

Every server describes its API at /api/v1/openapi.json (OpenAPI 3.1, generated from the code, stable through 1.x). Point a generator at it and you have a typed client:

curl -s https://todo.example.com/api/v1/openapi.json -o openapi.json
npx openapi-typescript openapi.json -o opentodo.d.ts

The same file is docs/openapi.json and an asset of every release. Sign in with an API token from Settings → Integrations → API tokens; the API guide has the details, and ot, the Obsidian plugin and the n8n nodes are clients built on it.

Under the hood
┌───────────────────────── device ─────────────────────────┐      ┌──────────── server ────────────┐
│ React PWA  ──►  IndexedDB (source of truth)              │      │ Go binary + SQLite             │
│                 │ every edit = field ops {ts, device}    │ sync │  ops log (append-only)         │
│                 └► outbox ──────────────────────────────►├─────►│  fields (last-writer-wins)     │
│                 ◄─ ops from other devices ◄──────────────┤◄─────┤  REST, CalDAV, email, import   │
└──────────────────────────────────────────────────────────┘      │  all write through ops         │
                                                                  └────────────────────────────────┘
  • Every change is a small operation that sets one field of one entity, stamped with a hybrid logical clock and the device id.
  • Devices apply changes locally first, then sync. The same per-field rule runs everywhere, so all devices agree no matter the order. Notes merge character by character.
  • The REST API, CalDAV, email and imports write through the same log, so a task created with curl shows up on your phone right away.
  • One Go binary with the web app inside and a single SQLite file. It idles at about 20 MB of memory and runs on a Raspberry Pi.

More in architecture and the sync protocol.

Help without coding

  1. Star and share. A star on GitHub helps other people find OpenTodo.
  2. Leave feedback in Discussions or on Discord.
  3. Report bugs in issues.
  4. Review a translation. The app speaks eleven languages; tell us where a word feels wrong (translating).
  5. Test it on your devices and report back in the call for testers.
  6. Answer questions from other people in Discussions and on Discord.
  7. Sponsor: buy me a coffee or GitHub Sponsors.

To contribute code, read CONTRIBUTING.md: changes that alter behaviour start as an OpenSpec change. Security issues go to the address in SECURITY.md.

Supporters

OpenTodo is free and always will be. If it helps you, you can buy a coffee or sponsor it; the support page says what it costs to run and where the money goes.

Thank you to everyone who keeps OpenTodo going. Supporters who want to be listed appear here.

Star History

Star History Chart

License

AGPL-3.0-only. You can run, study, modify and share OpenTodo freely. If you offer a modified version as a network service, you must offer its source under the same license. That is what keeps a self-hosted project from being quietly turned back into a subscription.

Frequently asked questions

Is OpenTodo free to use?

OpenTodo is open source under the AGPL-3.0 licence. There is no licence fee and no seat count — you can self-host it or, where the project offers one, pay a vendor for a managed version instead.

What does OpenTodo do?

Your tasks, your server. An open-source, local-first task manager you can host yourself. Everything you expect from a commercial task app, without the subscript

What is OpenTodo written in?

OpenTodo is primarily written in TypeScript. Its source is publicly available at https://github.com/OpenTodoApp/OpenTodo, and it has 546 GitHub stars.