Nia documentation · 3.2.2
Get started
Pick an installation method, create the first administrator and prepare nia-todo for normal use.Before you begin
You need a server or VM that can run Docker, or a supported Debian/Ubuntu system. For production use, also prepare a hostname such as todo.example.com and an HTTPS reverse proxy.
Your deployment must provide:
- one reachable TCP port (default:
8753) - persistent storage for the database and runtime files
- HTTPS for passkeys, secure browser features and native integrations
Choose an installation
Docker
Choose Docker when you already use Compose, Portainer, Kubernetes-style tooling or another container platform. Updates are performed by pulling and recreating the container.
Debian or Ubuntu package
Choose the full server package for a traditional systemd installation. It includes service units, a daily backup timer, command-line recovery tools and supported in-app server updates.
Complete the initial setup
- Start nia-todo and retrieve the installation’s one-time setup token from the service log or persistent token file.
- Open
http://YOUR-SERVER:8753/setupand enter the token. - Set the separate administrator password.
- Create the first user account. It receives administrator rights.
- Sign in at
http://YOUR-SERVER:8753/and open/adminto configure the instance.
The full first-run setup guide lists the token location for every installation method, the enforced step order, how to resume after an interruption, and when the token becomes unusable.
Production checklist
Before inviting users:
- Put the instance behind HTTPS and a reverse proxy.
- Set the exact Public base URL in
/admin, for examplehttps://todo.example.com. - Verify the allowed origins and trusted proxy list.
- Configure and test SMTP if you need invitations, password resets or email verification.
- Create a manual backup and verify where it is stored.
- Install the preferred native app or PWA from your own instance.
Keep the data volume persistent. Replacing a container without its volume creates a new, empty instance.