Why does the network scan find nothing, or almost nothing?

The scanner sees the network it is connected to. On a guest Wi-Fi, a VLAN or with a VPN active you scan that segment instead of your main one, which is the most common cause of a nearly empty list. On macOS, also check System Settings, Privacy & Security, Local Network: if DeviceShelf is not allowed there, a scan returns nothing at all. And give it half a minute: live hosts appear in seconds, names and identification follow.

Why does live bandwidth stay empty or greyed out?

Per-device bandwidth uses packet capture, which needs extra rights: Npcap on Windows, sudo or BPF access on macOS/Linux. Everything else in the app works without it.

Windows warns about an unknown publisher — is the download safe?

SmartScreen shows this warning for unsigned installers. Click More info, then Run anyway. The download's SHA-256 checksum is published next to every release, so you can verify what you run.

Why does the .deb not install on Ubuntu?

A double-clicked .deb opens Ubuntu's App Center, which can fail silently. Install it from the terminal instead: sudo apt install ./DeviceShelf-*.deb.

Why does my license not activate?

Paste the complete token from your purchase e-mail into Settings, License, with no line breaks. Verification runs offline, so no firewall can be in the way. If the token is rejected, reply to the purchase e-mail.

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 Windows Linux iPhone e Android Server 24/7 Attiva la licenza Risoluzione dei problemi

macOS notarizzato

Scarica il .dmg e aprilo.
Trascina DeviceShelf nella cartella Applicazioni.
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

Scarica l'installer (.exe) — x64 per Intel/AMD, oppure la build ARM64 per PC Snapdragon / Copilot+.
Eseguilo. Windows SmartScreen potrebbe segnalare un autore non verificato (la build non è firmata): clicca su Ulteriori informazioni → Esegui comunque.
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.

Verifica che in Home Assistant l'integrazione MQTT punti al tuo broker (va bene l'add-on Mosquitto, come qualsiasi broker esterno).
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.
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

Dopo l'acquisto ricevi una chiave di licenza via e-mail.
Nell'app: Impostazioni → Licenza, incolla la chiave, clicca su Attiva.
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

Funzione	Cosa richiede
Scansione, porte, report di sicurezza, IA	Niente: funziona ovunque, da subito
Banda in tempo reale per dispositivo	Windows: Npcap · macOS/Linux: permessi elevati (`sudo` o BPF/`setcap`)
Fingerprinting DHCP passivo	Permessi elevati su macOS/Linux · non disponibile su Windows

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

Quando qualcosa non funziona

La scansione non trova nulla, o quasi

Lo scanner vede la rete a cui è collegato. Su un Wi-Fi ospiti, una VLAN o con una VPN attiva scansioni quel segmento invece della tua rete principale: la causa più comune di un elenco quasi vuoto. Su macOS controlla anche Impostazioni di Sistema › Privacy e sicurezza › Rete locale: se DeviceShelf non è consentito lì, la scansione non restituisce nulla. E concedigli mezzo minuto: i dispositivi raggiungibili compaiono in pochi secondi, nomi e identificazione seguono.

La banda in tempo reale resta vuota o disattivata

La banda per dispositivo usa la cattura dei pacchetti, che richiede permessi aggiuntivi: Npcap su Windows, sudo o accesso BPF su macOS/Linux. Tutto il resto dell'app funziona anche senza. La pagina della banda spiega la configurazione per piattaforma.

Windows avvisa di un editore sconosciuto

SmartScreen lo mostra con gli installer non firmati. Clicca su Ulteriori informazioni → Esegui comunque. Il checksum SHA-256 del download è pubblicato accanto a ogni release, così puoi verificare cosa esegui.

Il .deb non si installa su Ubuntu

Un .deb aperto con doppio clic passa dall'App Center di Ubuntu, che può fallire in silenzio. Installalo invece dal terminale: sudo apt install ./DeviceShelf-*.deb. Dettagli sulla pagina Linux.

La licenza non si attiva

Incolla il token completo dell'e-mail di acquisto in Impostazioni › Licenza, senza interruzioni di riga. La verifica avviene offline, quindi nessun firewall può intralciare. Se il token viene rifiutato, rispondi all'e-mail di acquisto e lo sistemiamo.