Skip to content

Self-hosting: Requirements page#696

Open
YashMohan23 wants to merge 2 commits into
docs/self-hostingfrom
docs/self-hosting-requirements
Open

Self-hosting: Requirements page#696
YashMohan23 wants to merge 2 commits into
docs/self-hostingfrom
docs/self-hosting-requirements

Conversation

@YashMohan23

Copy link
Copy Markdown

What this is

Reworks the self-hosting Requirements page into a focused, requirements-only pre-install checklist, and renames the sidebar entry System requirementsRequirements (to match the target self-hosting tree).

What's included

  • Hardware tiers (Evaluation / Team / Production) with CPU / RAM / disk sizing.
  • Software table: Docker Engine 24.0+, Docker Compose v2.20+, Git 2.0+, each with a verify command, plus per-OS install tabs (macOS / Linux / Windows).
  • Platform compatibility table (the privileged: true requirement; Fargate / Cloud Run / managed PaaS unsupported).
  • Network ports reference: default + bind + .env key for every service.

What changed vs the existing page

  • Corrected to current facts from the live future-agi/future-agi repo: gateway env var AGENTCC_GATEWAY_PORT, app services bind 0.0.0.0 (not "internal only"), PeerDB ports only under COMPOSE_PROFILES=full.
  • Added Git as a prerequisite (needed for the git clone install step).
  • Fixed the Windows tab: WSL 2 memory is set in .wslconfig, not Settings → Resources.
  • Trimmed to requirements-only (removed production/security guidance and the env-vars card that belonged elsewhere).
  • No em/en dashes; ## Introduction opener to match the current self-hosting pages.

Validation needed

  • Confirm the hardware sizing tiers match what we recommend to customers.
  • Heading convention: used ## Introduction (matches the newest config pages) — happy to switch to ## About if preferred.

🤖 Generated with Claude Code

…on sidebar entries

- Requirements-only pre-install checklist: hardware tiers, software
  (Docker 24.0+, Compose v2.20+, Git 2.0+) with per-OS install tabs,
  platform compatibility, and the network-ports reference.
- Correct to current repo facts: AGENTCC_GATEWAY_PORT, 0.0.0.0 app-service
  binds, PeerDB ports only under COMPOSE_PROFILES=full.
- Add Git as a prerequisite; fix the Windows WSL 2 memory guidance.
- Sidebar: rename 'System requirements' -> 'Requirements' and add 'Installation'.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@YashMohan23 YashMohan23 force-pushed the docs/self-hosting-requirements branch from 0d6208c to 6f37ddc Compare June 29, 2026 14:53

@khushalsonawat khushalsonawat left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good draft. Check the changes below

Comment thread src/pages/docs/self-hosting/requirements.mdx Outdated
Comment thread src/pages/docs/self-hosting/requirements.mdx Outdated
Comment thread src/pages/docs/self-hosting/requirements.mdx Outdated
Comment thread src/pages/docs/self-hosting/requirements.mdx Outdated
Comment thread src/pages/docs/self-hosting/requirements.mdx Outdated
Comment thread src/pages/docs/self-hosting/requirements.mdx Outdated
- Title -> 'Requirements' (sync with sidebar); shorten description.
- 'Introduction' -> 'In this page'; intro three-checks as bullets.
- Note -> TLDR for the short-on-time summary.
- Uniform OS tabs (consistent lead line); remove stranded macOS Docker Desktop line.
- Update Install link + nav href for the install -> installation rename.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@YashMohan23

Copy link
Copy Markdown
Author

Thanks for the review — addressed all 6 comments:

  • Title → Requirements (sidebar sync); description shortened
  • Intro three-checks → bullets
  • NoteTL;DR
  • OS tabs made uniform (consistent lead line); removed the stranded macOS Docker Desktop line
  • Updated the Install link + nav for the install → installation rename (see Self-hosting: Installation page #697)

Ready for another look 🙏

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.

2 participants