Skip to content

[Docs] Add homelab deployment guide - #977

Draft
roomote-roomote[bot] wants to merge 1 commit into
developfrom
feature/homelab-deployment-guide-2n25ly5i9v29b
Draft

[Docs] Add homelab deployment guide#977
roomote-roomote[bot] wants to merge 1 commit into
developfrom
feature/homelab-deployment-guide-2n25ly5i9v29b

Conversation

@roomote-roomote

Copy link
Copy Markdown
Contributor

Created by Roomote. Follow up by mentioning @roomote-roomote, in the web UI, or in Slack.

What changed

  • add a homelab deployment guide centered on a full Proxmox VM, Tailscale administration, and a stable public HTTPS origin
  • compare direct public DNS, Cloudflare Tunnel, and Tailscale Funnel ingress paths with their operational tradeoffs
  • include a provider-agnostic prompt that a local agent can follow without collecting provider credentials or exposing the setup token
  • add the guide to Getting Started and link it from the existing self-hosting page

Why this change was made

The existing self-hosting guide covers the installer and production stack, but homelab operators still need help choosing VM resources, private access, public ingress, DNS, and tunnel behavior. This gives them an actionable path without duplicating the supported installer.

Impact

Homelab users can deploy Roomote with clearer infrastructure boundaries, understand why Tailscale complements rather than replaces public ingress, and hand safe host preparation steps to a local coding agent. The upstream Proxmox community helper script remains a separate follow-up and is not required by this guide.

@roomote-community

roomote-community Bot commented Aug 1, 2026

Copy link
Copy Markdown
Contributor

1 issue outstanding. See task

  • apps/docs/homelab.mdx:111 The public-DNS installer command, and the equivalent Cloudflare command at line 127, pipe into an unprivileged bash. deploy/install.sh exits unless it runs as root, so following either new primary setup path from a normal SSH account fails before installation. Pipe to sudo bash -s -- (or explicitly require a root shell).

Reviewed b232281

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