Preparation

Workspace VM Troubleshooting

Quick checks when connection, tools, or local services do not work as expected.

On this page

RDP or desktop does not respond

Check hostname, RDP port, and user on the workspace start page. Restart your RDP client and connect again. If the VM was provisioned recently, wait a moment until all services are ready.

Tool is unavailable

Open a new terminal and verify that asdf knows the expected version:

asdf current

If a project contains a .tool-versions file, switch into the project folder first and then start the dev script again.

Local service blocks the port

If a dev script fails because a port is already in use, stop the old process or old Docker containers. Backend projects start Docker services with docker compose; frontends and homepages use fixed, incremented local ports.

Project folder is missing

Check whether the repository was cloned and whether you are working in the shared group folder. If a repository is missing, clone it from the project group.