A workspace is a prepared Ubuntu development VM in the cloud: all tools are installed, the project repositories are ready, and you connect via remote desktop or open VS Code directly in the browser. Ideal when you don’t want to install anything locally, your hardware is weak, or someone needs to join on short notice.
Ready in three steps
- Create a workspace – pick a project, assign a user, the platform provisions the VM.
- Set up Tailscale – the VMs are only reachable through the private workspace network; set up once per device.
- Connect to your workspace – via RDP client or with VS Code in the browser.
Working inside the workspace
Inside the workspace you work just like locally: project folders live in the home directory, you start applications with ap run-local, and IDE and AI configuration come from your project’s local-configuration repository.
- Installed software – which tools are preinstalled.
- Working with projects – folder structure and workflow inside the VM.
- Starting applications – development servers with the
apCLI.
Going deeper
- Workspace VMs – technical background on the VMs.
- Desktop via RDP and Desktop via VNC – set up remote desktop clients.
- Troubleshooting – when connection or tools act up.