nia-todo documentation
Install on Debian or Ubuntu
Install the full nia-todo server bundle with systemd, backup tools and bundled native clients.The full .deb server bundle is intended for 64-bit Debian and Ubuntu systems. It installs nia-todo under /opt, keeps runtime data under /var/lib and runs the service as a dedicated system user.
Install the package
- Download
nia-todo-server-vX.Y.Z-full.debfrom the latest GitHub release. - Install it with APT:
sudo apt install ./nia-todo-server-vX.Y.Z-full.deb
- Check the service:
sudo systemctl status nia-todo
sudo journalctl -u nia-todo -f
- Open
http://YOUR-SERVER:8753/setup.
Installed layout
| Path | Purpose |
|---|---|
/opt/nia-todo |
Application and Python environment |
/var/lib/nia-todo |
Database, attachments, keys and backups |
/etc/nia-todo/nia-todo.env |
Service environment |
nia-todo.service |
Application service |
nia-todo-backup.timer |
Daily automatic backup |
Useful commands:
sudo systemctl restart nia-todo
sudo systemctl status nia-todo-backup.timer
sudo systemctl start nia-todo-backup.service
sudo journalctl -u nia-todo --since today
Service configuration
The default environment file contains:
NIA_TODO_HOST=auto
NIA_TODO_PORT=8753
NIA_TODO_DATA_DIR=/var/lib/nia-todo
NIA_TODO_DB=nia-todo.db
After changing it, restart the service:
sudo systemctl restart nia-todo
Keep custom avatar, attachment and VAPID paths inside NIA_TODO_DATA_DIR; the packaged backup helper is designed around that directory.
Included administration tools
sudo nia-todo-backup
sudo nia-todo-restore /path/to/backup.zip
sudo nia-todo-admin-password-reset
The package also supports verified in-app server updates. Continue with HTTPS and reverse proxy configuration.