Start with Docker Compose

1. Prepare your dashboard host

Use a host with Docker Engine, the Docker Compose plugin, Git and OpenSSL. NASitron monitors Ubuntu OpenZFS hosts over SSH; the dashboard does not need direct access to their disks. Allow the dashboard to reach each NAS over SSH.

2. Get the application

git clone https://github.com/StealthCat/NASitron.git
cd NASitron
cp .env.example .env
openssl rand -hex 32

Put the generated value into NASITRON_SECRET_KEY in .env. Set NASITRON_WEB_USERNAME, a long unique NASITRON_WEB_PASSWORD, and NASITRON_TLS_HOST to your dashboard hostname. Keep the encryption key stable and back it up securely: replacing it makes saved SSH and email secrets unreadable.

3. Start NASitron

docker compose up -d --build
docker compose ps
docker compose logs --tail=100 nasitron caddy

The supplied stack exposes Caddy on ports 80 and 443; the application port stays private. Choose alternative host ports with NASITRON_HTTP_PORT and NASITRON_HTTPS_PORT if those ports are occupied. Open your configured dashboard hostname over HTTPS and sign in.

Bootstrap TLS uses Caddy’s internal CA. Trust that CA on your clients, or configure ACME/uploaded certificates in Settings → HTTPS. A bootstrap certificate may initially show a browser trust warning.

4. Add your first NAS

Choose Add Server for the one-time enrollment command. Follow the host enrollment guide, then confirm that a fresh collection shows the expected pool and drive identities.