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.
| Field | Type | Description |
|---|---|---|
| Not started | idle | Workspace exists but no machines are running yet. Hit the Start button on the card to boot it. |
| Starting up | transient | Machines are booting and recipes are being applied. The card shows a blue loading bar that fills as boot progresses. Usually 30-90 seconds. |
| Running | steady | All machines booted and are reachable. The card shows a Console button (open the workspace) and a Stop button. |
| Stopped | steady | Workspace is paused. Disks and stacks are kept; compute is released. Use Clone to spin up a fresh copy. |
| Terminated | final | Duration 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"). |
| Failed | final | At least one machine failed to provision. Open Audit on the card to inspect logs, or Clone to retry. |
| Archived | soft-deleted | Hidden 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 or via easyenv status.
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.
