Installation unter Windows Server

Diese Anleitung beschreibt die Einrichtung von Argon On-Premises auf Windows Server mit Rancher Desktop als Container-Plattform. Rancher Desktop ist eine kostenlose Alternative zu Docker Desktop und stellt docker sowie docker compose unter Windows Server bereit.

Stellen Sie zuerst sicher, dass die Hardware-Voraussetzungen erfüllt sind.

Voraussetzungen (Windows Server)

Zusätzlich zu den Hardware-Anforderungen und der AVX-Unterstützung benötigen Sie:

• Windows Server 2022 oder Windows Server 2025 mit aktuellen Updates
• Windows Subsystem for Linux (WSL 2) — muss vor Rancher Desktop installiert sein
• Virtualisierung im BIOS/UEFI aktiviert (Intel VT-x / AMD-V)
• SSD als Speichermedium (siehe Hinweis zum Speicher)
• IPv6 auf dem Host aktiviert (siehe IPv6 prüfen)
• Mindestens 24 GB RAM auf dem Host empfohlen (32 GB+ bei SQL-Server-Container in Produktion; siehe Hardware)

Docker Desktop und Rancher Desktop nicht parallel nutzen

Installieren Sie nicht Docker Desktop und Rancher Desktop gleichzeitig. Beide Programme verwenden dieselben WSL-Integrationen und können sich gegenseitig stören. Deinstallieren Sie Docker Desktop vollständig, bevor Sie Rancher Desktop einrichten.

Schritt 1: WSL 2 installieren

Falls WSL noch nicht eingerichtet ist, öffnen Sie PowerShell als Administrator und führen Sie aus:

wsl --install

Starten Sie den Computer danach neu. Prüfen Sie die Installation mit:

wsl --status

Die Ausgabe sollte Standardversion: 2 anzeigen.

Schritt 2: Rancher Desktop installieren

1. Laden Sie den aktuellen Windows-Installer von der Rancher-Desktop-Releases-Seite herunter (Rancher.Desktop.Setup.X.Y.Z.msi).
2. Führen Sie den Installer aus und akzeptieren Sie die Lizenzbedingungen.
3. Wählen Sie bei der Abfrage „Für alle Benutzer installieren", damit der Rancher Desktop Privileged Service eingerichtet wird. Dieser ist für den Zugriff auf exponierte Ports (z. B. localhost:8080) erforderlich.
4. Schließen Sie die Installation ab und starten Sie Rancher Desktop.

Schritt 3: Rancher Desktop konfigurieren

Öffnen Sie Rancher Desktop und wechseln Sie zu Preferences (Zahnrad-Symbol). Konfigurieren Sie folgende Einstellungen:

Einstellung	Empfohlener Wert	Hinweis
Container Engine	moby (dockerd)	Erforderlich, damit docker und docker compose wie in dieser Anleitung funktionieren
Kubernetes	Deaktiviert	Spart Ressourcen; für Argon nicht benötigt
WSL Integration	Aktiviert für Ihre Standard-Distribution	Ermöglicht Docker-Befehle in WSL-Terminals

Ressourcen zuweisen: Unter Windows werden CPU und Arbeitsspeicher für die WSL-VM über die Datei %UserProfile%\.wslconfig gesteuert. Erstellen oder bearbeiten Sie diese Datei und passen Sie die Werte an Ihre Hardware an:

[wsl2]
memory=16GB
processors=6
swap=4GB

Ressourcen anpassen

Die Werte müssen zu Ihrer Hardware passen und unter dem verfügbaren Host-RAM bleiben (Windows benötigt zusätzlich ca. 4–8 GB). Für Argon mit SQL-Server-Container sind mindestens 16 GB RAM und 6 CPU-Kerne für WSL empfehlenswert; ohne SQL-Server genügen 12 GB RAM und 4 Kerne. Nach Änderungen an .wslconfig führen Sie in PowerShell aus:

wsl --shutdown

und starten Sie Rancher Desktop neu.

Installation prüfen: Öffnen Sie PowerShell oder Windows Terminal und führen Sie aus:

docker version
docker compose version

Beide Befehle sollten ohne Fehler eine Versionsausgabe liefern.

Schritt 4: Argon-Verzeichnis anlegen

Erstellen Sie einen Arbeitsordner für die Argon-Konfiguration, z. B. unter C:\argon:

mkdir C:\argon
cd C:\argon

Die empfohlene Verzeichnisstruktur und die Konfigurationsdateien (docker-compose.yaml, config.yaml, init.yaml) sind identisch mit der Linux-Installation. Legen Sie die Dateien wie in der Übersicht beschrieben an:

1. Anmelden an der Container Registry
2. docker-compose.yaml erstellen
3. config.yaml erstellen
4. init.yaml erstellen (optional)

Zeilenumbrüche in YAML-Dateien

Verwenden Sie einen Editor, der Unix-Zeilenenden (LF) unterstützt (z. B. VS Code, Notepad++). Windows-Zeilenenden (CRLF) in YAML-Dateien können zu Parse-Fehlern bei docker compose führen.

Schritt 5: Argon starten und nutzen

Stellen Sie sicher, dass Rancher Desktop läuft (Symbol in der Taskleiste sichtbar), bevor Sie Docker-Befehle ausführen.

1. Container Registry: Melden Sie sich wie in Schritt 1 an der Registry an.
2. Konfiguration: Erstellen und passen Sie docker-compose.yaml, config.yaml und optional init.yaml an.
3. Starten: Im Argon-Verzeichnis:

cd C:\argon
docker compose up -d

4. Status prüfen:

docker compose ps

5. Zugriff: Öffnen Sie im Browser http://localhost:8080 und melden Sie sich wie in Schritt 6 beschrieben an.

Argon unter Windows Server verwalten

Aktion	Befehl
Logs anzeigen	docker compose logs
Logs eines Dienstes	docker compose logs argon
Umgebung stoppen	docker compose down
Umgebung starten	docker compose up -d
Rancher Desktop beenden	Rechtsklick auf Taskleisten-Symbol → Quit Rancher Desktop

Rancher Desktop vor Docker-Befehlen starten

Wenn docker den Fehler error during connect oder Cannot connect to the Docker daemon meldet, ist Rancher Desktop nicht gestartet. Starten Sie die Anwendung über das Startmenü und warten Sie, bis das Taskleisten-Symbol erscheint.

IPv6 unter Windows Server prüfen

Argon benötigt IPv6 auf dem Host. Prüfen Sie in PowerShell:

Get-NetAdapterBinding -ComponentID ms_tcpip6 | Where-Object { $_.Enabled -eq $true }

Wenn keine aktivierten Einträge angezeigt werden, aktivieren Sie IPv6 für Ihre Netzwerkadapter unter Einstellungen → Netzwerk und Internet → Erweiterte Netzwerkeinstellungen → Weitere Adapteroptionen → Adaptereigenschaften → Internetprotokoll Version 6 (TCP/IPv6) aktivieren.

Bekannte Besonderheiten unter Windows Server

• Ports nur über localhost: Unter Windows Server sind exponierte Container-Ports standardmäßig nur über 127.0.0.1 erreichbar. Für den lokalen Zugriff auf Argon (http://localhost:8080) ist das ausreichend. Für Zugriff aus dem LAN siehe Externer Zugriff.
• Performance bei Volume-Mounts: Dateien in gemounteten Ordnern (./data, ./mssql usw.) liegen auf dem Windows-Dateisystem. Das ist für den Argon-Betrieb geeignet; bei sehr hoher I/O-Last kann ein Linux-Server performanter sein.
• Antivirus/Firewall: Stellen Sie sicher, dass Rancher Desktop, WSL und der Zugriff auf metaargon.azurecr.io nicht durch Firmen-Firewall oder Antivirus blockiert werden.

Häufige Probleme

docker oder docker compose funktioniert nicht

• Rancher Desktop gestartet? Die Anwendung muss laufen, bevor Docker-Befehle verfügbar sind.
• Container Engine auf moby (dockerd)? Unter Rancher Desktop → Preferences → Container Engine muss moby (dockerd) ausgewählt sein, nicht containerd.
• Docker Desktop entfernt? Parallele Installationen von Docker Desktop und Rancher Desktop führen zu Konflikten. Deinstallieren Sie Docker Desktop vollständig.
• Neues Terminal öffnen: Nach der Installation oder Konfiguration von Rancher Desktop ein neues PowerShell-/Terminal-Fenster öffnen, damit die PATH-Variablen geladen werden.
• WSL neu starten: Nach Änderungen an .wslconfig: wsl --shutdown in PowerShell ausführen und Rancher Desktop neu starten.