Skip to content

Self-hosting: Installation page#697

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

Self-hosting: Installation page#697
YashMohan23 wants to merge 2 commits into
docs/self-hostingfrom
docs/self-hosting-installation

Conversation

@YashMohan23

@YashMohan23 YashMohan23 commented Jun 29, 2026

Copy link
Copy Markdown

What this is

New self-hosting Installation page (new sidebar entry, after Requirements) documenting the current ./bin/install Docker Compose flow.

What's included

  • <Steps>: clone + ./bin/install, create the first user (manage.py create_user), open the app.
  • Installer flags: --full, --skip-user-creation, --no-up, --wipe-volumes, --new-instance.
  • Apple Silicon / arm64 note (amd64 images under Rosetta 2).
  • Manual (no-script) install, verify the stack, everyday operations, and the other run modes (development / frontend-only).
  • Deep dive card to Environment variables.

What changed vs the old draft

  • Uses the current published-image flow (./bin/install, ~1 min, no source builds) instead of the old build-from-source v1.8.19_base path.
  • First user via the real create_user management command (not a Django shell hack).
  • Stop / wipe via ./bin/uninstall (--wipe-data, --purge).
  • Frontend-only corrected: VITE_HOST_API needs a container restart, not a rebuild.
  • Every command verified against the live future-agi/future-agi repo. No em/en dashes.

Sidebar

  • Includes the same self-hosting nav change as the Requirements PR (Self-hosting: Requirements page #696): rename System requirementsRequirements and add Installation. Identical in both PRs so the sidebar stays consistent; the change is idempotent and won't conflict.

Note

  • A "System configuration" card was intended, but configuration/system.mdx is not in the base branch, so that card is omitted to avoid a broken link. Happy to add it once that page lands.

🤖 Generated with Claude Code

@YashMohan23 YashMohan23 force-pushed the docs/self-hosting-requirements branch from f2ed277 to 0d6208c Compare June 29, 2026 14:47
@YashMohan23 YashMohan23 force-pushed the docs/self-hosting-installation branch from 10b3986 to 91cb202 Compare June 29, 2026 14:48
@YashMohan23 YashMohan23 changed the base branch from docs/self-hosting-requirements to docs/self-hosting June 29, 2026 14:49
- New Installation page for the current ./bin/install flow: Steps (clone +
  install, create first user via manage.py create_user, open the app),
  installer flags, Apple Silicon/arm64 note, manual install, verify-the-stack,
  everyday operations, and the dev/frontend run modes.
- 'Deep dive' card to Environment variables (System configuration card omitted
  since that page is not in the base branch).
- Replaces the old build-from-source v1.8.19_base draft with the published-image
  flow; every command verified against the live future-agi/future-agi repo.
- 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-installation branch from 91cb202 to d3431e6 Compare June 29, 2026 14:54

@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.

First-round review against the docs review guide (review-docs-like-khushal). 9 inline comments below, keyed to the guide sections; several mirror the #696 Requirements feedback. Commands were verified against the future-agi repo and check out.

Comment thread src/pages/docs/self-hosting/install.mdx Outdated
Comment thread src/pages/docs/self-hosting/install.mdx Outdated
Comment thread src/pages/docs/self-hosting/install.mdx Outdated
Comment thread src/pages/docs/self-hosting/install.mdx Outdated
Comment thread src/pages/docs/self-hosting/install.mdx Outdated
Comment thread src/pages/docs/self-hosting/install.mdx Outdated
Comment thread src/pages/docs/self-hosting/install.mdx Outdated
Comment thread src/pages/docs/self-hosting/install.mdx Outdated
Comment thread src/lib/navigation.ts Outdated
- Rename install.mdx -> installation.mdx (file = kebab of sidebar title); nav href updated.
- Title -> 'Installation'; shorten description.
- 'Introduction' -> 'In this page'; bullet the installer-does-this enumeration (de-duped Step 1).
- Note -> TLDR. Footer 'Deep dive' -> 'Dive deeper'.
- Drop trailing periods in the flags + modes tables and the card body.
- Point the env card at the canonical nav path /docs/self-hosting/environment.

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

Copy link
Copy Markdown
Author

Thanks for the review — addressed all 9 comments:

  • Title → Installation; description shortened
  • IntroductionIn this page
  • Bulleted the installer enumeration (de-duped Step 1)
  • NoteTL;DR; footer Deep diveDive deeper
  • Dropped trailing periods in the flags/modes tables and card body
  • Env card now points to the canonical /docs/self-hosting/environment
  • Renamed install.mdx → installation.mdx (nav href updated)

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