Markdown

Entwicklungsumgebung

Fehlerbehebung

Prüfschritte für Workspaces, wenn die RDP-Verbindung scheitert, ein Werkzeug fehlt, ein Port belegt ist oder ein Projektordner fehlt.

Auf dieser Seite

Tailscale ist nicht verbunden

Zeigt die Tailscale-App nicht Connected oder fehlt deine Workspace-VM in tailscale status, ist dein Gerät nicht im Workspace-Netz. Melde dich am Server von MainPath an, nicht an einem gewöhnlichen Tailscale-Konto (Tailscale einrichten).

RDP oder Desktop reagiert nicht

Vergleiche Hostname, Port und Benutzername mit dem Dialog Verbinden auf der Workspace-Kachel, starte den RDP-Client neu und verbinde dich erneut; kurz nach dem VM-Start brauchen die Dienste einen Moment. workspace-<slug>.workspaces.vpn.application-platform.com wird nur über Tailscale aufgelöst; ein fremder Rechnername unter workspaces-dev.application-platform.com ist der öffentliche Gateway-DNS.

Windows App unter macOS: Passwort-Dialog, dann nichts

Zeigt die Windows App nach dem lokalen Passwort-Dialog weder Verbindung noch Fehlermeldung, prüfe im Terminal:

  1. tailscale status zeigt die Workspace-VM als online.
  2. dscacheutil -q host -a name workspace-<slug>.workspaces.vpn.application-platform.com liefert eine IP aus 100.64.x.x.
  3. nc -vz workspace-<slug>.workspaces.vpn.application-platform.com 3389 meldet den Port als erreichbar.

Klappen Schritt 2 und 3, verbinde dich testweise mit der Tailscale-IP statt dem MagicDNS-Namen oder nutze FreeRDP (sdl-freerdp) mit /cert:ignore für eine klare Fehlermeldung. Die Logs unter ~/Library/Containers/com.microsoft.rdc.macos/Data/Library/Logs/Windows App/ zeigen mit Name resolution failed oder Connection refused ein DNS- oder Routing-Problem, mit erfolgreichem RDP-Handshake ein Anmeldeproblem.

Fehler 0x207 („expired password“)

„expired password“ bei Error code: 0x207 führt in die Irre; meist passt das Passwort nicht zu gnome-remote-desktop auf der VM, oder der CredSSP-/NLA-Handshake bricht ab. Kopiere das Passwort aus dem Dialog Verbinden; meldet FreeRDP mit /cert:ignore AUTHENTICATION_FAILED, setze die Zugangsdaten auf der VM neu (grdctl --system rdp set-credentials …).

Zeigt nur die Windows App 0x207 oder SSL_ERR_HANDSHAKE_FAILED, braucht die .rdp-Datei diese Zeile (die Datei von MainPath setzt sie bereits):

use redirection server name:i:1

Lösche alte PC-Einträge in der Windows App und öffne die Datei neu, oder nutze sdl-freerdp … /cert:ignore /gfx.

Ein Werkzeug fehlt

Prüfe in einem neuen Terminal mit asdf current die Versionen, wechsle in den Projektordner mit der .tool-versions und starte mp run-local erneut; mp doctor zeigt, welches Werkzeug fehlt.

Ein Port ist belegt

Beende den alten Prozess oder Docker-Container, der den Port belegt, und starte mp run-local neu; mp ports zeigt, welcher Port zu welchem Repository gehört. Backends nutzen docker compose, Frontends und Homepages feste Ports.

Ein Projektordner fehlt

Prüfe, ob das Repository im gemeinsamen Projektordner geklont ist; fehlt es, klone es aus der GitLab-Gruppe nach (Mit Projekten arbeiten).

Danke für deine Anfrage

Wir haben deine Anfrage erhalten und melden uns schnellstmöglich bei dir.

Du möchtest direkt mit uns sprechen?

Buche hier einen passenden Termin für ein Erstgespräch mit Robin.

Kalender in einem neuen Tab öffnen