diff --git a/docs/help/faq.md b/docs/help/faq.md index f32ecb299..45bde9cde 100644 --- a/docs/help/faq.md +++ b/docs/help/faq.md @@ -442,6 +442,7 @@ Remote access: [Gateway remote](/gateway/remote). We keep a **hosting hub** with the common providers. Pick one and follow the guide: +- [VPS hosting](/vps) (all providers in one place) - [Railway](/railway) (one‑click, browser‑based setup) - [Fly.io](/platforms/fly) - [Hetzner](/platforms/hetzner) diff --git a/docs/platforms/index.md b/docs/platforms/index.md index 8184ea00c..1b5c85129 100644 --- a/docs/platforms/index.md +++ b/docs/platforms/index.md @@ -23,6 +23,7 @@ Native companion apps for Windows are also planned; the Gateway is recommended v ## VPS & hosting +- VPS hub: [VPS hosting](/vps) - Railway (one-click): [Railway](/railway) - Fly.io: [Fly.io](/platforms/fly) - Hetzner (Docker): [Hetzner](/platforms/hetzner) diff --git a/docs/vps.md b/docs/vps.md new file mode 100644 index 000000000..f32402d66 --- /dev/null +++ b/docs/vps.md @@ -0,0 +1,34 @@ +--- +summary: "VPS hosting hub for Clawdbot (Railway/Fly/Hetzner/exe.dev)" +read_when: + - You want to run the Gateway in the cloud + - You need a quick map of VPS/hosting guides +--- +# VPS hosting + +This hub links to the supported VPS/hosting guides and explains how cloud +deployments work at a high level. + +## Pick a provider + +- **Railway** (one‑click + browser setup): [Railway](/railway) +- **Fly.io**: [Fly.io](/platforms/fly) +- **Hetzner (Docker)**: [Hetzner](/platforms/hetzner) +- **exe.dev** (VM + HTTPS proxy): [exe.dev](/platforms/exe-dev) + +## How cloud setups work + +- The **Gateway runs on the VPS** and owns state + workspace. +- You connect from your laptop/phone via the **Control UI** or **Tailscale/SSH**. +- Treat the VPS as the source of truth and **back up** the state + workspace. + +Remote access: [Gateway remote](/gateway/remote) +Platforms hub: [Platforms](/platforms) + +## Using nodes with a VPS + +You can keep the Gateway in the cloud and pair **nodes** on your local devices +(Mac/iOS/Android/headless). Nodes provide local screen/camera/canvas and `system.run` +capabilities while the Gateway stays in the cloud. + +Docs: [Nodes](/nodes), [Nodes CLI](/cli/nodes)