Primi passi
Prerequisiti
Hardware, software, rete e decisioni da preparare prima dell'installazione.
Installazione Docker consigliata
- Un host Linux con Docker Engine e Docker Compose
2.24.0o successivo; - Accesso da riga di comando con i permessi necessari per eseguire container;
- Porta TCP
2504disponibile, o un'altra porta host a scelta; - Storage persistente per l'interezza di
/app/data; - Accesso di rete dal container NasDash alle integrazioni di destinazione;
- Una strategia di backup separata dal disco o volume primario.
Il file Compose fornito esegue il mount di /var/run/docker.sock, una convenzione Linux. Docker Desktop può eseguire NasDash, ma l'accesso a Docker locale deve essere adattato, e questo non è il percorso convalidato dal file fornito.
Sviluppo da sorgente
- Node.js
22.x, conforme al motore dichiarato e all’immagine; - npm con lockfile del repository;
- Playwright Chromium per test browser;
- Docker per verifiche immagine e persistenza.
Decisioni da prendere prima del primo avvio
| Domanda | Scelta consigliata |
|---|---|
| Dove memorizzare i dati? | ./data per impostazione predefinita; volume con nome solo come alternativa facoltativa per una nuova installazione |
| Chi può vedere la dashboard? | Modalità privata per un'istanza contenente informazioni sensibili |
| Accesso remoto? | Tailscale o reverse proxy HTTPS; non pubblicare la porta 2504 direttamente su Internet |
| Azioni Docker? | Mantieni POST=1 solo se necessario e DELETE=0 per impostazione predefinita |
| Segreto iniziale? | Lascia che NasDash lo generi e lo renda persistente, o forniscine uno esplicitamente per un deployment avanzato |
Verificare Docker Compose
docker version
docker compose versionIl secondo comando deve riportare Compose 2.24.0 o successivo. Questa versione supporta il file opzionale .env utilizzato dalla configurazione pronta da copiare. La sintassi storica docker-compose non è quella utilizzata dalle guide.