Kassen-Server auf Windows Server installieren

Kurz zusammengefasst

Programmdatei herunterladen, nach C:\degaso\kasse legen, einmal testweise starten, Port 3434 in der Firewall freigeben und das Programm mit dem kostenlosen Werkzeug NSSM als Windows-Dienst einrichten. Node.js oder andere Laufzeitumgebungen müssen Sie nicht installieren — alles steckt in der einen Datei.

Voraussetzungen

Was	Anforderung
Betriebssystem	Windows Server 2016, 2019, 2022 oder 2025 — 64 Bit (x64). Windows 10/11 funktioniert genauso.
Rechte	Ein Benutzerkonto mit Administratorrechten (für Dienst und Firewall).
Speicher	Mindestens 1 GB freier Plattenplatz, 2 GB Arbeitsspeicher.
Netzwerk	Feste IP-Adresse im Firmennetz empfohlen. Die Kassengeräte müssen den Server auf TCP-Port `3434` erreichen.
Internet	Ausgehende HTTPS-Verbindungen (Port 443) zur degaso Cloud und zur TSE müssen erlaubt sein.

Downloads

Sie benötigen zwei Dateien:

degaso Kassen-Server für Windows Die Programmdatei cash-server.exe. Der Link führt immer zur aktuellen Version. Die Datei heißt beim Herunterladen ServerWindows_degaso-cash-<Version>.exe.
Kassen-Server herunterladen (.exe)
NSSM – Non-Sucking Service Manager Ein kleines, kostenloses Werkzeug, das ein normales Programm als Windows-Dienst laufen lässt. Laden Sie die ZIP-Datei von nssm.cc/download herunter (Version 2.24). Darin brauchen Sie nur die Datei win64\nssm.exe.

Installation Schritt für Schritt

Alle Befehle werden in der PowerShell als Administrator ausgeführt: Startmenü öffnen, „PowerShell“ eingeben, Rechtsklick → Als Administrator ausführen.

Ordner anlegen Der Kassen-Server legt seine Datenbank im selben Ordner ab, in dem er gestartet wird. Wir verwenden deshalb einen festen Ordner:
```
New-Item -ItemType Directory -Force C:\degaso\kasse\logs
```
Dateien hineinlegen Kopieren Sie die heruntergeladene Datei nach C:\degaso\kasse\cash-server.exe und nssm.exe (aus dem Ordner win64 der ZIP-Datei) nach C:\degaso\nssm.exe. Benennen Sie die Kassen-Server-Datei bei Bedarf um, sodass sie genau cash-server.exe heißt — das macht spätere Updates einfacher.
Danach die Download-Sperre von Windows entfernen:
```
Unblock-File C:\degaso\kasse\cash-server.exe
Unblock-File C:\degaso\nssm.exe
```
Testweise starten Einmal von Hand starten, um zu sehen, dass alles funktioniert:
```
cd C:\degaso\kasse
.\cash-server.exe
```
Nach wenigen Sekunden erscheint HTTP Server running on port 3434. Öffnen Sie auf dem Server im Browser http://localhost:3434 — die degaso Kasse wird angezeigt. Im Ordner ist jetzt zusätzlich der Unterordner databases entstanden.
Beenden Sie den Testlauf mit Strg + C.
Firewall freigeben Damit die Kassengeräte den Server erreichen, eingehende Verbindungen auf Port 3434 erlauben:
```
New-NetFirewallRule -DisplayName "degaso Kasse" -Direction Inbound `
  -Protocol TCP -LocalPort 3434 -Action Allow -Profile Domain,Private
```
Falls das Netzwerk des Servers als „Öffentlich“ eingestuft ist, ergänzen Sie ,Public beim Profil.

Als Windows-Dienst einrichten So startet der Kassen-Server automatisch mit Windows — auch ohne dass jemand angemeldet ist — und wird nach einem Absturz neu gestartet. Den ganzen Block auf einmal einfügen:

$nssm = "C:\degaso\nssm.exe"
& $nssm install degaso-kasse C:\degaso\kasse\cash-server.exe
& $nssm set degaso-kasse AppDirectory C:\degaso\kasse
& $nssm set degaso-kasse DisplayName "degaso Kassen-Server"
& $nssm set degaso-kasse Description "degaso Kasse – lokaler Kassen-Server (Port 3434)"
& $nssm set degaso-kasse Start SERVICE_AUTO_START
& $nssm set degaso-kasse AppStdout C:\degaso\kasse\logs\server.log
& $nssm set degaso-kasse AppStderr C:\degaso\kasse\logs\server.log
& $nssm set degaso-kasse AppRotateFiles 1
& $nssm set degaso-kasse AppRotateOnline 1
& $nssm set degaso-kasse AppRotateBytes 10485760
& $nssm start degaso-kasse

Wichtig: `AppDirectory` nicht weglassen

Ohne diese Einstellung startet der Dienst in C:\Windows\System32 und legt dort eine neue, leere Datenbank an. Die Kasse wirkt dann „zurückgesetzt“.

Prüfen, ob der Dienst läuft
```
Get-Service degaso-kasse
```
Die Spalte Status muss Running zeigen. Den Dienst finden Sie auch unter services.msc › degaso Kassen-Server. Die Ausgaben des Servers stehen in C:\degaso\kasse\logs\server.log.
Kassengeräte verbinden Die IP-Adresse des Servers ermitteln Sie mit ipconfig (Zeile „IPv4-Adresse“). Auf den Kassengeräten im Netzwerk rufen Sie dann die Kasse unter http://IP-des-Servers:3434 auf, zum Beispiel http://192.168.1.20:3434.

Fertig

Der Kassen-Server läuft jetzt dauerhaft als Dienst. Die Einrichtung der Kasse selbst (Verknüpfung mit Ihrem degaso-Konto, TSE, Drucker) erfolgt wie gewohnt in der Kasse und in der degaso Cloud.

Update auf eine neue Version

Bei einem Update wird nur die Programmdatei ausgetauscht. Der Ordner databases bleibt unberührt — niemals löschen oder überschreiben, dort liegen Ihre Kassendaten.

# 1. Dienst anhalten
Stop-Service degaso-kasse

# 2. Sicherheitskopie der Datenbank anlegen
Copy-Item C:\degaso\kasse\databases "C:\degaso\backup-$(Get-Date -Format yyyy-MM-dd)" -Recurse

# 3. Neue cash-server.exe nach C:\degaso\kasse kopieren (alte Datei ersetzen), dann:
Unblock-File C:\degaso\kasse\cash-server.exe

# 4. Dienst wieder starten
Start-Service degaso-kasse

Datensicherung

Alle lokalen Daten des Kassen-Servers liegen in C:\degaso\kasse\databases. Nehmen Sie diesen Ordner in Ihre reguläre Server-Sicherung auf. Abgeschlossene Belege und Tagesabschlüsse werden zusätzlich in der degaso Cloud gespeichert.

Wenn etwas nicht klappt

Problem	Ursache und Lösung
„Der Computer wurde durch Windows geschützt“	SmartScreen-Hinweis beim ersten Start. Auf Weitere Informationen → Trotzdem ausführen klicken, oder vorher `Unblock-File` ausführen (Schritt 2).
Datei verschwindet nach dem Kopieren	Der Virenschutz hat sie in Quarantäne verschoben. Den Ordner `C:\degaso\kasse` als Ausnahme eintragen und die Datei wiederherstellen.
Start bricht mit `EADDRINUSE` ab	Port 3434 ist schon belegt — meist läuft der Server bereits (z. B. als Dienst und zusätzlich von Hand). Prüfen mit `netstat -ano \| findstr 3434`.
Auf dem Server geht es, auf den Kassen nicht	Firewall-Regel aus Schritt 4 fehlt oder das Netzwerkprofil passt nicht. Testen vom Kassengerät aus: `http://IP-des-Servers:3434` im Browser.
Kasse ist nach Dienst-Einrichtung leer	`AppDirectory` fehlt (Schritt 5). Setzen, Dienst neu starten — die Daten aus dem Testlauf liegen weiterhin in `C:\degaso\kasse\databases`.
Dienst startet nicht oder stoppt sofort	In `C:\degaso\kasse\logs\server.log` nachsehen und die letzten Zeilen an unseren Support schicken.

Dienst wieder entfernen

Stop-Service degaso-kasse
C:\degaso\nssm.exe remove degaso-kasse confirm

Support

Wir helfen gern bei der Einrichtung: telefonisch unter +49 9566 8004900 oder per E-Mail an info@degaso.de.