diff --git a/environment-setup/deploy-local.mdx b/environment-setup/deploy-local.mdx
index 2fa8e21..82f22a8 100644
--- a/environment-setup/deploy-local.mdx
+++ b/environment-setup/deploy-local.mdx
@@ -7,7 +7,7 @@ description: "Run a tracebloc workspace on a single machine — laptop or on-pre
 
 ## Prerequisites
 
-- A machine: macOS, Linux, or Windows · 2 CPU · 4 GB RAM · 20 GB free disk.
+- A machine: macOS, Linux, or Windows · 2 CPU · 5 GB RAM · 10 GB free disk to run (4 CPU · 16 GB · 50 GB to train on it).
 - Your **Client ID** and password from the [clients page](https://ai.tracebloc.io/clients).
 
 That's it — no Docker or Kubernetes knowledge needed. The installer sets up Docker and the cluster for you.
diff --git a/environment-setup/quickstart.mdx b/environment-setup/quickstart.mdx
index 333e179..dd5622d 100644
--- a/environment-setup/quickstart.mdx
+++ b/environment-setup/quickstart.mdx
@@ -13,10 +13,10 @@ A running workspace in about 10 minutes, with one command. Deploying on a specif
 
 | You need | Minimum |
 |---|---|
-| A machine | macOS, Linux, or Windows · 2 CPU · 4 GB RAM · 20 GB free disk |
+| A machine | macOS, Linux, or Windows · 2 CPU · 5 GB RAM · 10 GB free disk |
 | A tracebloc account | [Sign up free](https://ai.tracebloc.io) — no credit card |
 
-The installer runs below these too — it only warns, and more RAM mainly helps once models train.
+That's enough to run a workspace. To **train on this machine**, give it 4 CPU · 16 GB RAM · 50 GB disk — a single training job alone reserves ~8 GB. The installer checks before it starts: below the minimum it stops on Linux (on macOS/Windows it warns — raise Docker Desktop's memory in Settings → Resources).
 
 <Steps>
   <Step title="Register your workspace">
diff --git a/environment-setup/setup-guide.mdx b/environment-setup/setup-guide.mdx
index a9eb9bb..4a0fffd 100644
--- a/environment-setup/setup-guide.mdx
+++ b/environment-setup/setup-guide.mdx
@@ -13,13 +13,13 @@ The installer deploys a **single-node workspace on one machine** — a local Kub
 
 ## Requirements
 
-The installer runs on any modern machine (one host per workspace). These are the minimum specs to run a workspace comfortably:
+The installer runs on any modern machine (one host per workspace) and **checks these before it starts** — below the minimum it stops on Linux with a clear message (on macOS/Windows it warns; raise Docker Desktop's memory in Settings → Resources). "To run" keeps a workspace online; **training on the same machine needs the headroom** — a single training job alone reserves ~8 GB.
 
-| | Minimum | Recommended |
+| | To run the workspace | To train on this machine |
 |---|---------|-------------|
-| **CPU** | 2 cores | 8+ cores |
-| **RAM** | 4 GB | 16+ GB |
-| **Disk** | 20 GB free | 50+ GB free |
+| **CPU** | 2 cores | 4+ cores |
+| **RAM** | 5 GB | 16 GB |
+| **Disk** | 10 GB free | 50+ GB free |
 
 **Supported platforms:** macOS (Intel & Apple Silicon) · Linux (x86_64 & arm64) · Windows (x86_64 & arm64)