Documentation

nia-todo is built for private self-hosting. The server contains the web app, the API and the downloads for the matching native clients. Most installations need only one persistent data directory and an HTTPS reverse proxy.

Choose your path

Install nia-todo

• Docker: Recommended for most self-hosters and container platforms.
• Debian or Ubuntu: A full server package with systemd service, backup timer and in-app updates.
• Get started: Compare both options and finish the initial setup.

Configure your instance

• HTTPS and reverse proxy: Public URL, headers, CORS and trusted proxies.
• Administration: Users, email, attachments and instance settings.
• Security, 2FA and OIDC: Passkeys, MFA policy and single sign-on.
• BrainDump: Optional voice-to-todo with your STT and LLM providers.

Keep it running

• Apps and PWA: Web, Windows, Android and Debian clients.
• Backup and restore: What to persist and how to recover it.
• Updates: Update Docker or the Debian package safely.
• Troubleshooting: Logs and common configuration problems.

What belongs in these docs?

This website documents the released product from an administrator and user perspective: installation, setup, configuration, clients, integrations and day-two operations.

Developer internals, architecture, test suites and the release workflow stay in the GitHub repository, close to the source code they describe.

nia-todo is under active development. The documentation follows stable releases; settings visible only on a development build can differ.