Guida a installazione e configurazione

Tutto pronto in un paio di minuti. Scegli la piattaforma, installa e avvia la prima scansione. Una licenza copre tutti i tuoi dispositivi.

macOS notarizzato

  1. Scarica il .dmg e aprilo.
  2. Trascina DeviceShelf nella cartella Applicazioni.
  3. Aprilo dal Launchpad o dalla cartella Applicazioni. È notarizzato da Apple, quindi si apre e basta, senza avvisi di sicurezza.

Requisiti: macOS 12 o successivo (Apple Silicon e Intel). La banda in tempo reale per dispositivo richiede permessi elevati — vedi banda in tempo reale. Tutto il resto funziona da subito.

Windows

  1. Scarica l'installer (.exe) — x64 per Intel/AMD, oppure la build ARM64 per PC Snapdragon / Copilot+.
  2. Eseguilo. Windows SmartScreen potrebbe segnalare un autore non verificato (la build non è firmata): clicca su Ulteriori informazioni → Esegui comunque.
  3. Segui l'installer e avvia DeviceShelf.

Per la banda in tempo reale: installa Npcap. Su Windows la banda per dispositivo si legge catturando i pacchetti, e serve Npcap. L'installer te lo segnala; puoi anche scaricare Npcap e riavviare DeviceShelf. Scansione, porte, report di sicurezza e tutto il resto funzionano senza Npcap.

Approfondimento: attivare la banda in tempo reale.

Linux

DeviceShelf arriva come AppImage (gira ovunque, senza installazione) e come pacchetti nativi .deb / .rpm, per x86-64 e ARM64.

Stai installando il .deb? Usa il terminale, non il doppio clic — su Ubuntu 24.04 un .deb aperto con doppio clic finisce nell'App Center e può fallire in silenzio:

sudo apt install ./DeviceShelf-*.deb

La guida Linux completa (AppImage, .rpm, permessi di cattura): Installare su Linux.

iPhone e Android

DeviceShelf per iPhone e iPad è sull'App Store. Android arriva come APK diretto che installi tu — non esiste una scheda su Google Play. La tua chiave di licenza vale su desktop e su mobile, quindi un acquisto copre tutti i tuoi dispositivi.

Farlo girare 24/7 su un server incluso

Per un monitoraggio continuo c'è un'edizione server senza interfaccia: in Docker, via .deb o come servizio Windows. Puntala sulle reti da tenere d'occhio 24 ore su 24. La tua licenza attuale la copre: stessa chiave, nessun costo aggiuntivo.

Novità nella 1.5.3: il server include un server MCP locale — collega Claude, Cursor o qualsiasi agente IA e interroga la tua rete in linguaggio naturale. Guida al collegamento →

Installazione, avvisi, configurazione del token ed esempi di connessione MCP stanno nella guida al server.

Home Assistant

L'edizione server pubblica i tuoi dispositivi su Home Assistant via MQTT. Home Assistant li scopre da solo, quindi dal suo lato non c'è nulla da installare oltre all'integrazione MQTT e a un broker: niente add-on, niente componente personalizzato.

  1. Verifica che in Home Assistant l'integrazione MQTT punti al tuo broker (va bene l'add-on Mosquitto, come qualsiasi broker esterno).
  2. Nella dashboard del server apri Impostazioni → Integrazioni → Home Assistant, inserisci l'indirizzo del broker (192.168.1.10:1883 basta) e aggiungi utente e password se il tuo broker li richiede.
  3. Spunta Pubblica su Home Assistant e premi Prova connessione. Le entità compaiono nel giro di un intervallo di scansione.

Ogni dispositivo esportato diventa un dispositivo Home Assistant con un sensore di presenza, l'IP e la latenza, e porta produttore, modello, tipo, sistema operativo e porte aperte come attributi. Accanto ci sono contatori di rete e un'entità evento che scatta su dispositivi nuovi, su dispositivi spariti e su porte appena aperte, così un'automazione può reagire quando un apparecchio sconosciuto entra nella tua rete.

Preferiti e infrastruttura (gateway, router, switch, access point, NAS, stampanti) vengono pubblicati in automatico. Ogni altro dispositivo si aggiunge o si esclude singolarmente dalla sua scheda di dettaglio.

Attiva la tua licenza

  1. Dopo l'acquisto ricevi una chiave di licenza via e-mail.
  2. Nell'app: Impostazioni → Licenza, incolla la chiave, clicca su Attiva.
  3. Su iPhone e Android apri l'e-mail della licenza sul dispositivo e tocchi il pulsante di attivazione: il resto va da sé.

Nessun account, nessun controllo online: l'attivazione è offline. La stessa chiave attiva anche tutti gli altri tuoi dispositivi. Approfondimento: attivare DeviceShelf.

I permessi a colpo d'occhio

FunzioneCosa richiede
Scansione, porte, report di sicurezza, IANiente: funziona ovunque, da subito
Banda in tempo reale per dispositivoWindows: Npcap · macOS/Linux: permessi elevati (sudo o BPF/setcap)
Fingerprinting DHCP passivoPermessi elevati su macOS/Linux · non disponibile su Windows

Senza di essi l'app gira lo stesso: resta inattiva solo la funzione in questione.

Altro aiuto

Guide e approfondimenti