Skip to content

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

Merged
LukasWodka merged 1 commit into
developfrom
docs/sizing-reconcile
Jun 6, 2026
Merged

docs(environment-setup): reconcile machine sizing with the preflight gate#54
LukasWodka merged 1 commit into
developfrom
docs/sizing-reconcile

Conversation

@LukasWodka

Copy link
Copy Markdown
Contributor

What

Reconcile the stated machine sizing with the new installer preflight gate (tracebloc/client#217), which now hard-fails below ~5 GB RAM on Linux instead of only warning — so the old "it only warns" line in the quickstart was wrong.

  • quickstart, deploy-local, setup-guide: minimum-to-run 2 CPU / 5 GB / 10 GB vs recommended-to-train 4 CPU / 16 GB / 50 GB, stated consistently.
  • Removed the now-false "it only warns" line; note that the installer checks before it starts (stops on Linux, warns on macOS/Windows).
  • Numbers match the chart's real footprint: always-on ~2.1 GiB requests + k3s + OS ≈ 4.4 GiB just to be Online; a single training job reserves ~8 GB.

Pairs with tracebloc/client#217 · refs tracebloc/backend#744

🤖 Generated with Claude Code

…gate

The installer now hard-fails below ~5 GB RAM on Linux (was warn-only), so the old
"it only warns" line was wrong. State minimum-to-run (2 CPU / 5 GB / 10 GB) vs
recommended-to-train (4 CPU / 16 GB / 50 GB) consistently across quickstart,
deploy-local, and the setup guide. A single training job reserves ~8 GB.

Pairs with tracebloc/client#217 · refs tracebloc/backend#744

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@LukasWodka

Copy link
Copy Markdown
Contributor Author

👋 Heads-up — Code review queue is at 22 / 8

Above the WIP limit. The team convention is to review existing PRs before opening new work.

Open PRs currently in Code review (oldest first):

Pull from review before opening new work. (This is a nudge from the kanban WIP check, not a block.)

@LukasWodka LukasWodka merged commit f84e9ef into develop Jun 6, 2026
4 checks passed
@LukasWodka LukasWodka deleted the docs/sizing-reconcile branch June 6, 2026 16:06
LukasWodka added a commit that referenced this pull request Jun 6, 2026
Mintlify dev preview at tracebloc-develop.mintlify.app was returning 404
on every page that wasn't part of a recent incremental build. Confirmed
by curl: the 3 paths touched by #54 returned 200, all others 404.

Adding a trailing newline to all 31 .mdx files marks them as changed in
git so Mintlify's incremental builder treats every page as needing
update, restoring full dev preview coverage.

No content change — just file-mtime/hash bump.

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant