DeviceShelf Server für Windows (amd64)
=============================================

Die headless 24/7-Edition von DeviceShelf: scannt dein Netzwerk laufend,
meldet neue/verschwundene Geräte, überwacht Ports/WAN/DNS/TLS und stellt ein
Dashboard + eine API bereit — ohne GUI. Gleiche Engine wie die Desktop-App.


>>> ZUERST DAS (Windows 11 / Smart App Control) <<<
---------------------------------------------------
Dieser Windows-Build ist noch nicht signiert, daher markiert Windows die Dateien als
"aus dem Internet" und SmartScreen/Smart App Control warnt evtl. bei install.exe.
In 5 Sekunden behoben, VOR dem Entpacken:

  Rechtsklick auf die heruntergeladene .ZIP  ->  Eigenschaften
   ->  Häkchen bei "Zulassen"  ->  OK
  ...dann die Zip entpacken. Jetzt läuft install.exe normal.

(Warnt SmartScreen trotzdem: „Weitere Informationen" -> „Trotzdem ausführen".
Blockt Smart App Control hart, nutze die Kommandozeilen-Installation unten. Ein
signierter Release ist geplant.)


INSTALLIEREN (empfohlen) — als 24/7-Dienst
------------------------------------------
1. install.exe doppelklicken und die Windows-Admin-Nachfrage (UAC) bestätigen.
   Der Dienst wird installiert und gestartet; danach werden Dashboard-URL und
   Zugangs-Token angezeigt und das Dashboard im Browser geöffnet.
2. Fertig — der Dienst läuft im Hintergrund und startet mit Windows.

Deinstallieren: uninstall.exe doppelklicken (ebenfalls UAC bestätigen).


WENN WINDOWS DIE DATEI BLOCKIERT (unsignierter Build)
---------------------------------------------------
Dieser Windows-Build ist noch nicht signiert, daher warnt Windows evtl.:
- SmartScreen („Der Computer wurde geschützt"): „Weitere Informationen" ->
  „Trotzdem ausführen".
- Vor dem Entpacken: Rechtsklick auf die .zip -> Eigenschaften -> Häkchen bei
  „Zulassen" -> OK, dann entpacken.  (PowerShell: Unblock-File .\*.exe)
- Smart App Control (Windows 11, falls AN) blockiert unsignierte Apps hart; bis
  wir einen signierten Build ausliefern, müsste es auf Aus/Evaluierung stehen.
  Ein signierter Release ist geplant.


DASHBOARD & TOKEN
-----------------
- URL auf dem Server selbst:    http://localhost:8088
- URL von einem anderen Gerät:  http://<IP-dieses-Servers>:8088
- Ein Token wird IMMER verlangt, sobald das Dashboard im LAN erreichbar ist
  (Standard). Du erfindest keins — der Server erzeugt es beim ersten Start.
- Token jederzeit ablesen, in einer Eingabeaufforderung in diesem Ordner:
    deviceshelf-server.exe -token
  (wird auch von install.exe und auf der Konsole eines von Hand gestarteten
   Servers angezeigt; oder die Datei direkt lesen:
    type "%windir%\System32\config\systemprofile\AppData\Roaming\DeviceShelf\api-token")
- Beim ersten Browser-Aufruf den Token eingeben.
- Firewall-Nachfrage mit „Zugriff zulassen" bestätigen, damit der Scan das
  lokale Netz erreicht.


SCHNELLTEST OHNE INSTALLATION
-----------------------------
deviceshelf-server.exe doppelklicken — zeigt Token und Dashboard-URL auf der
Konsole und scannt das LAN. Fenster schließen oder Strg+C zum Beenden.


KOMMANDOZEILEN-INSTALLATION (optional — falls install.exe blockiert wird)
------------------------------------------------------------------------
install.exe kapselt nur diese Befehle; führe sie bei Bedarf selbst aus (oder
falls Smart App Control den Installer blockt). Öffne eine ADMIN-Eingabe-
aufforderung: Start -> "cmd" eingeben -> Rechtsklick -> "Als Administrator
ausführen". Dann:
    cd /d "PFAD\ZUM\ENTPACKTEN\ORDNER"
    deviceshelf-server.exe -service install
    deviceshelf-server.exe -service start
    deviceshelf-server.exe -token          (zeigt den Dashboard-Token)
Das macht genau dasselbe wie install.exe. Deinstallieren: -service stop,
danach -service uninstall.


KONFIGURATION (optional, System-Umgebungsvariablen)
---------------------------------------------------
Als Administrator setzen, dann Dienst neu starten:
  Lizenz (sonst 7-Tage-Test):  setx /M DEVICESHELF_LICENSE "DEIN-TOKEN"
  Eigener API-Token:           setx /M DEVICESHELF_API_TOKEN "langer-zufallswert"
  Port / Intervall:            setx /M DEVICESHELF_API_PORT "8088"
                               setx /M DEVICESHELF_INTERVAL "5m"
Neu starten:  deviceshelf-server.exe -service stop  &&  ... -service start


HINWEISE
--------
- Der Dienst läuft als „Lokales System"; seine Daten liegen unter dem
  Systemprofil, nicht in deinem Benutzerordner (siehe Token-Pfad oben).
- Passives DHCP-Fingerprinting ist unter Windows nicht verfügbar (wie in der
  Desktop-App). Scannen, Monitoring, SNMP, Alarme, Dashboard, API: voll dabei.
- LIVE-BANDBREITE / AKTIVES ARP: die Standard-deviceshelf-server.exe läuft
  ohne Paketmitschnitt. Wenn Npcap installiert ist (https://npcap.com), nimm
  stattdessen deviceshelf-server-pcap.exe — derselbe Server, zusätzlich mit
  Live-Bandbreite pro Gerät und aktivem ARP-Scan. Ohne Npcap startet diese
  Exe nicht; die Standard-Exe läuft immer.
- Fragen/Bugs: hello@deviceshelf.app
