Vorbereitung

Workspace VM – Fehlerbehebung

Schnelle Checks, wenn Verbindung, Tools oder lokale Services nicht wie erwartet laufen.

Auf dieser Seite

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.

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.