Presets
A preset (WorkspaceKind) is a reusable template that bundles the choices you make when creating a session — which IDE, which container images, which compute sizes, and which storage volumes are available. Instead of picking images and pod sizes from scratch every time, you select a preset and the wizard pre-fills around it.
Presets appear across Workbench in three contexts:
| Context | Where | What it does |
|---|---|---|
| Session presets | Presets tab | Defines the image catalog, pod sizes, and default storage for interactive sessions. Full CRUD — admins and users can create, edit, and delete them. |
| Training presets | Training Jobs tab | Read-only named combos of runtime + sizing. Managed by your admin via ConfigMap. |
| Inference presets | Endpoints tab | Compute and replica defaults for inference endpoints. Full CRUD. |
This section covers session presets. Training and inference presets are documented in their respective sections.
How presets relate to sessions
When you create a session, the first step is picking a preset. The preset determines:
- IDE type — JupyterLab, VS Code, or RStudio.
- Image catalog — which container images you can choose from (e.g. PyTorch, TensorFlow).
- Pod sizes — the compute options (CPU, memory, GPU) available for that session.
- Default storage — the home volume and any pre-mounted data volumes.
After selecting a preset, you choose an image from its catalog, a pod size, and configure storage. The session then references the preset by name, so any future changes to the preset's catalog are reflected in new sessions.
The presets list
The list view shows every preset in your workspace as a tile grid. Each tile displays:
- Display name and description — what the preset is for.
- IDE type — JupyterLab, VS Code, or RStudio.
- Image count — how many container images are in the catalog.
- Pod size count — how many compute options are available.
- In-use count — how many active sessions currently use this preset.
Click a tile to open the detail view, where you can see the full image catalog, all pod sizes, and any sessions currently running on this preset.
Next steps
- Creating a preset — step-by-step wizard walkthrough
- Reference — every field, type, and constraint
- Creating a session — how presets feed into session creation