nia-todoDocs
Menu

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

  1. Download nia-todo-server-vX.Y.Z-full.deb from the latest GitHub release.
  2. Install it with APT:
sudo apt install ./nia-todo-server-vX.Y.Z-full.deb
  1. Check the service:
sudo systemctl status nia-todo
sudo journalctl -u nia-todo -f
  1. 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.