RDP oder Desktop reagiert nicht
Prüfe Hostname, RDP-Port und Benutzer auf der Workspace-Startseite. Starte den RDP-Client neu und verbinde dich erneut. Wenn die VM frisch bereitgestellt wurde, warte kurz, bis alle Dienste gestartet sind.
Der RDP-/SSH-Hostname muss workspace-<slug>.workspaces.application-platform.com sein und per Tailscale auflösen. Wenn du per SSH auf *.workspaces-dev.application-platform.com landest und root@proxmox siehst, nutzt du den öffentlichen Gateway-DNS – das ist nicht die Workspace-VM.
Windows App (macOS): Passwort-Dialog, dann nichts
Der Passwort-Dialog erscheint oft lokal, bevor die Verbindung steht. Ohne sichtbare Fehlermeldung prüfe zuerst Tailscale:
- Tailscale ist verbunden und MagicDNS aktiv (
tailscale statuszeigt den Workspace-Host als online). - Der Hostname löst auf:
dscacheutil -q host -a name workspace-<slug>.workspaces.application-platform.com→ IP im Bereich100.64.x.x. - Port erreichbar:
nc -vz workspace-<slug>.workspaces.application-platform.com 3389.
Wenn Schritt 2/3 lokal klappt, die Windows App aber still scheitert, verbinde testweise mit der Tailscale-IP (100.64.x.x) statt dem MagicDNS-Namen – die App löst MagicDNS manchmal nicht zuverlässig auf. Alternativ: FreeRDP (sdl-freerdp) mit /cert:ignore für eine klare Fehlermeldung.
Windows-App-Logs: ~/Library/Containers/com.microsoft.rdc.macos/Data/Library/Logs/Windows App/. Typische Einträge: Name resolution failed / Connection refused (DNS/Route) vs. erfolgreicher RDP-Handshake danach.
Fehler 0x207 („expired password“)
Nach dem Passwort-Dialog erscheint oft Error code: 0x207. Der Text „expired password“ ist irreführend – meist stimmt das RDP-Passwort nicht mit gnome-remote-desktop überein, oder der CredSSP-/NLA-Handshake bricht ab. Nutze das Passwort aus dem Platform-Connect-Dialog (kopieren), nicht ein anderes Account-Passwort. Wenn FreeRDP mit /cert:ignore AUTHENTICATION_FAILED meldet, Credentials auf der VM neu setzen (grdctl --system rdp set-credentials …).
macOS Windows App + GNOME Remote Login: Wenn FreeRDP funktioniert, die Windows App aber 0x207 / SSL_ERR_HANDSHAKE_FAILED zeigt, muss in der .rdp-Datei stehen:
use redirection server name:i:1
(nicht i:0). Die von der Platform heruntergeladene RDP-Datei setzt das bereits. Alte PC-Einträge in der Windows App löschen und die Datei neu öffnen. Alternative: FreeRDP (sdl-freerdp … /cert:ignore /gfx).
Tool ist nicht verfügbar
Öffne ein neues Terminal und prüfe, ob asdf die erwartete Version kennt:
asdf current
Wenn ein Projekt eine .tool-versions enthält, wechsle zuerst in den Projektordner und starte danach das Dev-Script erneut.
Lokaler Service belegt den Port
Wenn ein Dev-Script wegen eines belegten Ports abbricht, beende den alten Prozess oder die alten Docker-Container. Backend-Projekte starten ihre Docker-Services über docker compose; Frontends und Homepages verwenden feste, hochgezählte lokale Ports.
Projektordner fehlt
Prüfe, ob das Repository geklont wurde und ob du im gemeinsamen Gruppenordner arbeitest. Falls ein Repository fehlt, klone es aus der Projektgruppe nach.