nia-todoDocs
Menu

nia-todo documentation

Updates

Update Docker or Debian installations while preserving data and keeping a rollback path.

Read the release notes and create a current backup before major updates.

Docker

Docker installations are updated outside the app:

docker compose pull
docker compose up -d
docker compose logs --tail=200 nia-todo

The admin panel can report that a newer version exists, but it does not replace a running container itself. Keep the persistent /data volume attached when recreating the service.

For controlled deployments, pin a version instead of latest:

image: docker.io/weedpump/nia-todo:2.0.0

Debian or Ubuntu

Supported full-package installations can update from /admin. nia-todo downloads the release package, verifies its published SHA256 checksum, creates a pre-upgrade SQLite backup, installs through a restricted root helper and restarts the service.

Manual update remains available:

sudo apt install ./nia-todo-server-vX.Y.Z-full.deb
sudo systemctl status nia-todo

The package preserves runtime data and creates a pre-upgrade database backup when a database exists.

After updating

  1. Confirm the reported server version.
  2. Check logs for migration or startup errors.
  3. Open a project and create a disposable todo.
  4. Verify attachments and realtime updates.
  5. Download updated native clients when the release includes them.

Do not downgrade across database migrations unless the release notes explicitly say it is supported. Restore the pre-upgrade backup with the previous application version instead.