Skip to content

docs(environment-setup): reconcile machine sizing with the preflight gate #54

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
LukasWodka merged 1 commit into from
Jun 6, 2026
Merged

docs(environment-setup): reconcile machine sizing with the preflight gate #54

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion environment-setup/deploy-local.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
4 changes: 2 additions & 2 deletions environment-setup/quickstart.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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">
Expand Down
10 changes: 5 additions & 5 deletions environment-setup/setup-guide.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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)

Expand Down
Loading