NiaDocs
4.0.0
Menu

Nia documentation · 4.0.0

Install on Debian or Ubuntu

Install the full Nia 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 under /opt, keeps runtime data under /var/lib and runs the service as a dedicated system user.

Download the full server bundle for your chosen release and use the corresponding documentation version.

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. Read the one-time token with sudo journalctl -u nia-todo, then open http://YOUR-SERVER:8753/setup. See first-run setup for the token file and resume procedure.

Installed layout

Path Purpose
/opt/nia-todo Application and Python environment
/var/lib/nia-todo All module data and recipe images in SQLite; attachment/avatar files, 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.