DeviceShelf Server per Windows (amd64)
=============================================
(English: README.txt · Deutsch: README.de.txt · Français: README.fr.txt
 Español: README.es.txt · العربية: README.ar.txt · 中文: README.zh.txt)

L'edizione headless 24/7 di DeviceShelf: scansiona la rete di continuo, avvisa
su dispositivi nuovi/assenti, controlla porte/WAN/DNS/TLS e offre una dashboard
+ un'API, senza interfaccia grafica. Stesso motore dell'app desktop.


>>> FAI PRIMA QUESTO (Windows 11 / Smart App Control) <<<
---------------------------------------------------------
Questa build Windows non è ancora firmata, perciò Windows contrassegna i file come
«provenienti da Internet» e SmartScreen/Smart App Control potrebbe avvisare su
install.exe. Si risolve in 5 secondi, PRIMA di estrarre:

  Clic destro sul .ZIP scaricato  ->  Proprietà  ->  spunta «Annulla
   blocco»  ->  OK
  ...poi estrai lo zip. Ora install.exe parte normalmente.

(Se SmartScreen avvisa comunque: «Ulteriori informazioni» -> «Esegui
comunque». Se Smart App Control è ATTIVO e lo blocca del tutto, usa
l'installazione da riga di comando più in basso. È previsto un rilascio firmato.)


INSTALLARE (consigliato) — come servizio 24/7
---------------------------------------------
1. Doppio clic su  install.exe  e conferma la richiesta di amministratore (UAC).
   Il servizio viene installato e avviato; vengono mostrati l'URL della
   dashboard e il token di accesso, e la dashboard si apre nel browser.
2. Fatto — il servizio gira in background e parte con Windows.

Disinstallare: doppio clic su  uninstall.exe  (conferma anche l'UAC).


SE WINDOWS BLOCCA IL FILE (build non firmata)
--------------------------------------------
Questa build Windows non è ancora firmata, perciò Windows potrebbe avvisare:
- SmartScreen («Windows ha protetto il PC»): «Ulteriori informazioni» ->
  «Esegui comunque».
- Prima di estrarre: clic destro sul .zip scaricato -> Proprietà -> spunta
  «Annulla blocco» -> OK, poi estrai.  (PowerShell: Unblock-File .\*.exe)
- Smart App Control (Windows 11, se ATTIVO) blocca in modo netto le app non
  firmate; finché non rilasciamo una build firmata dovresti impostarlo su
  Disattivato/Valutazione. È previsto un rilascio firmato.


DASHBOARD E TOKEN
-----------------
- URL sul server:            http://localhost:8088
- URL da un altro dispositivo: http://<IP-di-questo-server>:8088
- Un token è SEMPRE necessario quando la dashboard è raggiungibile sulla LAN
  (impostazione predefinita). Non lo inventi mai — il server ne genera uno al
  primo avvio.
- Leggi il token in qualsiasi momento, da un terminale in questa cartella:
    deviceshelf-server.exe -token
  (viene mostrato anche quando parte install.exe e sulla console di un server
   avviato a mano; oppure leggi direttamente il file:
    type "%windir%\System32\config\systemprofile\AppData\Roaming\DeviceShelf\api-token")
- Al primo accesso dal browser, incolla il token quando richiesto.
- Consenti l'accesso se il Firewall di Windows lo chiede, così la scansione
  raggiunge la tua LAN.


TEST RAPIDO SENZA INSTALLARE
----------------------------
Doppio clic su  deviceshelf-server.exe  — mostra il token e l'URL della
dashboard sulla console e scansiona la LAN. Chiudi la finestra o premi Ctrl+C
per fermarlo.


INSTALLAZIONE DA RIGA DI COMANDO (facoltativa — se install.exe è bloccato)
--------------------------------------------------------------------------
install.exe non fa che avvolgere questi comandi; eseguili tu stesso se
preferisci, o se Smart App Control blocca l'installer. Apri un terminale da
AMMINISTRATORE: Start -> digita «cmd» -> clic destro -> «Esegui come
amministratore». Poi:
    cd /d "PERCORSO\ALLA\CARTELLA\ESTRATTA"
    deviceshelf-server.exe -service install
    deviceshelf-server.exe -service start
    deviceshelf-server.exe -token          (mostra il token di accesso al dashboard)
Fa esattamente quello che fa install.exe. Disinstallare: -service stop, poi
-service uninstall.


CONFIGURAZIONE (facoltativa, variabili d'ambiente di sistema)
-------------------------------------------------------------
Da amministratore, poi riavvia il servizio:
  Licenza (altrimenti prova 7 giorni): setx /M DEVICESHELF_LICENSE "IL-TUO-TOKEN"
  Token API proprio:           setx /M DEVICESHELF_API_TOKEN "valore-casuale-lungo"
  Porta / intervallo:          setx /M DEVICESHELF_API_PORT "8088"
                               setx /M DEVICESHELF_INTERVAL "5m"
Riavvia:  deviceshelf-server.exe -service stop  &&  ... -service start


NOTE
----
- Il servizio gira come Sistema locale; i suoi dati sono sotto il profilo di
  sistema, non nella tua cartella utente (vedi il percorso del token sopra).
- Il fingerprinting DHCP passivo non è disponibile su Windows (come nell'app
  desktop). Scansione, monitoraggio, SNMP, avvisi, dashboard, API: tutto incluso.
- Domande/bug: hello@deviceshelf.app
