Create a workspace

Walk through the three-step Create New Workspace flow: pick a template, compose machines from recipes and stacks, then finalize.

Open Workspaces#

Sign in to the dashboard and click Workspaces -> All workspaces in the left nav. Each card on this page is one workspace - status pill on the left, kebab menu top-right, machine and stack icons across the bottom.

dashboard.easyenv.io/dashboard/acme-engineering/workspaces
EEasyEnv
A
acme-engineering
Team plan
J
John Doe
acme-engineering
All workspaces
+ New Workspace
Running⋮
Python Dev Env +5
6 recipes and 4 stacks · by John Doe · 3h ago
PPRVC+1ConsoleStop
Terminated·1h 0m⋮
MongoDB +3
4 recipes · by John Doe · 10h ago
MNRPCloneAudit
Terminated·1h 5m⋮
bench-kde-1777956542
1 recipe · by John Doe · 15h ago
KCloneAudit
Failed⋮
bench-grafana-1777956330
1 recipe · by John Doe · 15h ago
GClone
Terminated·1h 0m⋮
EasyEnv V2
1 recipe and 4 stacks · by John Doe · 20h ago
PCGVDCloneAudit
Starting up⋮
data-pipeline
2 recipes · by John Doe · just now
PJCloneAudit
All workspaces. Status pill (with run duration on terminated cards), title + meta line, machine + stack icons, action row.
What the icons mean
The disc-shaped icons along the bottom are your machines (from recipes) followed by your stacks. They overlap left-to-right and truncate to +N when the workspace has more than five. Hover any card on the real dashboard to see the full breakdown.

Step 1 - Choose a Workspace Template#

Click + New Workspace. The wizard opens with a three-step header: Choose a Workspace Template → Add Machines → Finalize. Pick a template whose machines and stacks are close to what you need, or start with the empty template and compose your own from scratch in step 2.

Templates are a starting point, not a cage
After picking a template you can still add machines, remove machines, swap recipes, and reconfigure stacks in step 2. The template just seeds the workspace with sensible defaults.

Step 2 - Add Machines#

This screen shows every machine that will boot. Each machine card has the recipe icon and name in the header, the stacks attached to that machine listed underneath, and a footer with the chosen vCPU / RAM / disk. Click + Add Machine to add another, or the pencil/copy/trash icons on a card to edit, duplicate, or remove it.

dashboard.easyenv.io/dashboard/acme-engineering/workspaces/new
EEasyEnv
A
acme-engineering
Team plan
J
John Doe
Workspace list / New Workspace
Create New Workspace
✓Choose a Workspace Template
2Add Machines
3Finalize
Machines · 1 of Unlimited machines used
PPython Dev Env⋯
VVS Code
CClaude
ZZsh
DDocker Image
GGitHub
4 CPU|8 GB|50 GB
+Add MachinePick a base, stacks, and resources
BackNext
Step 2: Add Machines. Each card shows the recipe + stacks + chosen resources for one machine.

The Add a Machine modal#

Clicking Add Machine opens a 3-step modal: Pick a Recipe → Add Stacks → Resources. Each step is a separate screen with its own next button.

The recipe is the base of the machine: which OS to boot, which packages to pre-install, which services to start. Each recipe maps to one Ansible role on the backend. Browse the catalog or use the search to filter.

Stacks layer additional tools on top of the recipe. The catalog ships with the following stacks; the Kubernetes-only ones are muted and only enabled when the recipe is a k8s cluster (k3s, kind, k8s_cluster).

Add a Machine
esc
✓Pick a Recipe
2Add Stacks
3Resources
🔍Search stacks…
ⓘGGitHub
ⓘCClaude
ⓘBBash
ⓘAAnsible
ⓘVVS Code
ⓘDDocker Image
ⓘDDockerfile
ⓘDDocker Compose
ⓘZZsh
ⓘHHelm
ⓘKKustomize
ⓘAArgoCD
ⓘFFluxCD
ⓘTTraefik
ⓘCcert-manager
ⓘLLonghorn
ⓘCCilium
ⓘCCalico
ⓘKKubernetes Gateway API
ⓘIIstio Ingress Gateway
ⓘPPrometheus + Grafana
ⓘKk9s
CancelBackResourcesAdd Machine

Some stacks need configuration once selected: GitHub asks for a repository URL, Docker Image asks for an image list, Bash and Ansible give you an editor for the script or playbook. The form adapts based on the stack.

Pick vCPU, RAM, and disk for this machine. Defaults come from the recipe; the maximum is capped by your account plan.

Step 3 - Finalize#

Give the workspace a name, set a Duration (the time budget after which EasyEnv automatically stops the workspace), and click Create workspace. The wizard closes and the new workspace card appears in the list with status Starting up. The blue progress bar across the top edge of the card fills as each machine boots.

After it boots#

When every machine reports active, the card flips to Running and the action row swaps from a progress bar to a Console + Stop pair. Click Console to open the workspace console (terminals, AI chat, port view) - see Workspace console for the layout.

From the CLI#

If you live in the terminal, the same operation is one command:

bash
# Create a workspace from a template
easyenv workspace create \
  --template python-dev-single \
  --name review-pr-1284 \
  --ttl 8h \
  --wait

See the full flag set in the CLI workspace reference.

Troubleshooting#

  • Stuck in Starting up: open the workspace audit (Audit on a failed card or the audit link from the workspace details dialog) and read the boot log. A recipe that depends on a slow apt mirror can take several minutes on first boot.
  • Plan limit reached: stop or archive an unused workspace, or upgrade your plan.
  • Failed status: hit Clone on the failed card to spin up a fresh copy with the same recipes and stacks. Inspect the original via Audit to see what went wrong.
Create a workspace | Docs | EasyEnv