Skip to content

[Docs] Make self-hosting setup paths explicit - #3381

Draft
roomote-roomote[bot] wants to merge 1 commit into
developfrom
docs/self-hosting-start-here-20hua3wdrdxtr
Draft

roomote-roomote[bot] wants to merge 1 commit into
developfrom
docs/self-hosting-start-here-20hua3wdrdxtr

Conversation

@roomote-roomote

Copy link
Copy Markdown
Contributor

​Opened on behalf of @mrubens. View the task or mention @roomote-roomote for follow-up asks.

What changed

  • make the self-hosting landing page explicitly treat homelab deployments as self-hosting and route readers by where Roomote will run
  • put host, ingress, sign-in, and inference prerequisites before the install command
  • define a completed setup as a reachable deployment with working inference and one successful task, not just running containers
  • separate Roomote Cloud as the hosted alternative while keeping Railway, Render, server, homelab, VM, and local-development paths distinct

Why this change was made

The existing page mixed hosted and self-hosted paths, placed its setup checklist after the installer, and left the end-to-end success condition unclear. That made it harder for a new homelab operator to choose the right guide and know what needed to be ready before starting.

Impact

Self-hosted operators now get a decision-first path from their intended host to the right guide, see prerequisites before installation, and have a concrete definition of a usable deployment. The deeper homelab and agent-guided installation contracts remain unchanged.

Screenshots

Rendered self-hosting start paths, prerequisites, and completion criteria

@roomote-community

roomote-community Bot commented Oct 2, 2026 •

Copy link
Copy Markdown
Contributor

1 issue outstanding. See task

  • apps/docs/self-hosting.mdx:51 — The prerequisite list incorrectly requires a sign-in provider even though the installer supports first-admin email/password bootstrap.

Reviewed e1a4ef3

- a public HTTPS origin that browsers and provider callbacks can reach; the
installer can create a temporary hostname for a short evaluation on a server
with a directly reachable public IPv4 address
- a sign-in provider for the people who will use the deployment

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.

A sign-in provider is not required before installation: the installer setup link admits the founding admin, who can create an email/password account, and later users can use invite links with email/password. Listing a provider as required makes a valid self-hosted path look blocked until Slack or Microsoft Teams is configured. Make this optional or include email/password bootstrap as the alternative.

This branch has not been deployed

No deployments
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