Skip to content

Add OpenHands Enterprise sizing guide [PLTF-3389] - #710

Merged
dylan-openhands merged 1 commit into
mainfrom
dj/sizing_guide
Aug 10, 2026
Merged

Add OpenHands Enterprise sizing guide [PLTF-3389]#710
dylan-openhands merged 1 commit into
mainfrom
dj/sizing_guide

Conversation

@dylan-openhands

Copy link
Copy Markdown
Contributor
  • I have read and reviewed the documentation changes to the best of my ability.
  • If the change is significant, I have run the documentation site locally and confirmed it renders as expected.

Summary of changes

"How big a box do I need?" is the first question on every Enterprise deployment call, and we had no answer in the docs — just a single trial-baseline VM spec buried in Quick Start, which says nothing about what happens at 50 or 500 concurrent users. This ports the internal sizing guide to the docsite so customers and CEs can size a deployment without a call.

The guide sizes on peak concurrent sandboxes rather than headcount, since sandboxes are the bulk of the footprint and one user can run several at once. Everything derives from one planning unit (0.5 vCPU / 4 GiB / 10 GiB node disk / 10 GiB volume per sandbox), with a table per install mode: Replicated embedded cluster on a single VM, and Replicated Helm into an existing cluster.

  • enterprise/sizing-guide.mdx — new page. Planning unit, VM sizing table (5–100 peak sandboxes with example GCP/AWS/Azure machine types and data disks), Helm sizing table (10–1,000 peak sandboxes with node pool min/max, platform nodes, volume storage, PostgreSQL sizing), and post-rollout adjustment guidance.
  • docs.json — nav entry under Enterprise → OpenHands Enterprise, between enterprise-vs-oss and quick-start. It sits above both install paths because it applies to both and is a pre-install decision; nesting it under VM Install or K8s Install would hide it from half its audience.
  • enterprise/quick-start.mdx — note framing the 16 vCPU / 64 GiB requirement as the trial baseline (~15 concurrent sandboxes), pointing here for larger rollouts.
  • enterprise/k8s-install/index.mdx, enterprise/k8s-install/resource-limits.mdx, enterprise/index.mdx — cross-links from the places where sizing decisions actually get made.

Verified with mint dev locally: page and nav render, tables lay out correctly. mint broken-links passes clean.

Note: llms.txt / llms-full.txt are intentionally not regenerated here. They're already stale on main, so running the generator pulls ~1,650 lines of unrelated drift into this diff. The weekly check-llms-files workflow will pick this page up.

@mintlify

mintlify Bot commented Aug 10, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
all-hands-ai 🟢 Ready View Preview Aug 10, 2026, 3:05 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@dylan-openhands
dylan-openhands merged commit 5ee6850 into main Aug 10, 2026
5 checks passed
@dylan-openhands
dylan-openhands deleted the dj/sizing_guide branch August 10, 2026 15:12
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.

3 participants