Workspaces overview

A workspace is the unit of work in EasyEnv. It bundles one or more virtual machines, the people who can reach them, and the lifetime of the whole environment.

Anatomy of a workspace#

Every workspace has four moving parts:

  • Machines: real virtual machines (Linux VMs) that actually run your code. A workspace has between one and a dozen, depending on your plan.
  • Recipes: each machine was provisioned from one recipe. The recipe ID is visible on the machine detail page.
  • Members: the users who can open the workspace, run terminals, and edit files.
  • Duration: a per-workspace time budget set at create time. When it runs out, EasyEnv stops the workspace, the status flips to Terminated, and the actual run-time shows up as a small badge on the card (e.g. Terminated · 1h 0m).

Lifecycle#

Each workspace status is shown on its card with a colored dot and label. The names below are exactly what the dashboard prints.

FieldTypeDescription
Not startedidleWorkspace exists but no machines are running yet. Hit the Start button on the card to boot it.
Starting uptransientMachines are booting and recipes are being applied. The card shows a blue loading bar that fills as boot progresses. Usually 30-90 seconds.
RunningsteadyAll machines booted and are reachable. The card shows a Console button (open the workspace) and a Stop button.
StoppedsteadyWorkspace is paused. Disks and stacks are kept; compute is released. Use Clone to spin up a fresh copy.
TerminatedfinalDuration ran out and the workspace shut down on its own. The card shows the actual run-time as a small chip next to the status pill (e.g. "Terminated · 1h 0m").
FailedfinalAt least one machine failed to provision. Open Audit on the card to inspect logs, or Clone to retry.
Archivedsoft-deletedHidden from the main list and moved to the Archived view in the sidebar. Reversible: hit Unarchive on the card to bring it back.

Resource limits#

How many concurrent workspaces you can run, and how big each machine can be, is governed by your account plan. View the current limits at /dashboard/<account>/settings/plan.

Hit a limit?
Stop unused workspaces from the dashboard, or upgrade your plan from the billing page. Limits are enforced at create time, never silently in the background.
Workspaces overview | Docs | EasyEnv