Skip to content

Workspaces

The Workspaces sidebar entry isn't a Waveshift page — it's an auto-login link to the Kasm Workspaces UI for your account.

How it works

Clicking the entry calls the orchestrator's GetKasmLoginUrl RPC, which returns a one-time login URL signed for your username. The URL opens in a new browser tab (target="_blank", rel="noopener,noreferrer") so the Waveshift session and the Kasm session stay isolated.

You're delivered straight to the Kasm dashboard with no second sign-in prompt. From there, every container and workspace configured for your account is reachable.

When the entry shows up

The entry appears whenever your account holds the workspaces licence (set by an administrator on the Users page). That licence can only be assigned while Kasm is enabled under Integrations. The sidebar doesn't check Kasm's health, so the entry can be visible while Kasm is down — in that case clicking it fails as described below.

If it fails

Clicking the entry shows a red Workspaces unavailable toast if the orchestrator can't generate a login URL. Common causes:

  • Kasm integration is disabled — admin needs to enable it under Integrations.
  • Kasm health check is failing — admin should hit Recheck on the Kasm card under Integrations to surface the underlying error.
  • Your Kasm user wasn't created — if you've recently been given the workspaces licence, the orchestrator may not have provisioned a Kasm user yet. Wait a minute and try again, or ask your administrator to confirm.