Note
Prerequisite for all connection paths: your device is signed in to the private workspace network with Tailscale.
Finding the connection details
Click Connect on the workspace card. The dialog shows everything you need:
- RDP address (
hostname:port, default port 3389) - Username and password (copyable)
- A Download RDP file button – the file opens directly in your RDP client
Right after creation it can take a moment until the VM has an address – the dialog points this out.
Option 1: Desktop via RDP
- Prepare your RDP client – recommendations and step-by-step instructions in Desktop via RDP.
- Download the RDP file or enter address and user manually.
- Sign in with the displayed password.
After login, the prepared project folders are available in the home directory. Alternatively there is Desktop via VNC if your workspace offers it.
Option 2: VS Code in the browser
Via the Apps button on the workspace card you open VS Code Web directly in the browser – no RDP client needed. You can immediately work on code, open terminals, and start applications with ap run-local.
If the connection fails
First check address, user, and Tailscale status. If that doesn’t help, read Workspace VM troubleshooting.