2026-01-25 00:20:01 +00:00
|
|
|
|
---
|
2026-01-30 03:15:10 +01:00
|
|
|
|
summary: "VPS hosting hub for OpenClaw (Oracle/Fly/Hetzner/GCP/exe.dev)"
|
2026-01-25 00:20:01 +00:00
|
|
|
|
read_when:
|
|
|
|
|
|
- You want to run the Gateway in the cloud
|
|
|
|
|
|
- You need a quick map of VPS/hosting guides
|
2026-01-31 16:04:03 -05:00
|
|
|
|
title: "VPS Hosting"
|
2026-01-25 00:20:01 +00:00
|
|
|
|
---
|
2026-01-31 21:13:13 +09:00
|
|
|
|
|
2026-01-25 00:20:01 +00:00
|
|
|
|
# VPS hosting
|
|
|
|
|
|
|
|
|
|
|
|
This hub links to the supported VPS/hosting guides and explains how cloud
|
|
|
|
|
|
deployments work at a high level.
|
|
|
|
|
|
|
|
|
|
|
|
## Pick a provider
|
|
|
|
|
|
|
2026-02-05 17:45:01 -05:00
|
|
|
|
- **Railway** (one‑click + browser setup): [Railway](/install/railway)
|
|
|
|
|
|
- **Northflank** (one‑click + browser setup): [Northflank](/install/northflank)
|
2026-01-26 14:23:11 -05:00
|
|
|
|
- **Oracle Cloud (Always Free)**: [Oracle](/platforms/oracle) — $0/month (Always Free, ARM; capacity/signup can be finicky)
|
2026-02-05 17:45:01 -05:00
|
|
|
|
- **Fly.io**: [Fly.io](/install/fly)
|
|
|
|
|
|
- **Hetzner (Docker)**: [Hetzner](/install/hetzner)
|
|
|
|
|
|
- **GCP (Compute Engine)**: [GCP](/install/gcp)
|
|
|
|
|
|
- **exe.dev** (VM + HTTPS proxy): [exe.dev](/install/exe-dev)
|
2026-01-25 00:23:24 +00:00
|
|
|
|
- **AWS (EC2/Lightsail/free tier)**: works well too. Video guide:
|
2026-02-06 10:08:59 -05:00
|
|
|
|
[https://x.com/techfrenAJ/status/2014934471095812547](https://x.com/techfrenAJ/status/2014934471095812547)
|
2026-01-25 00:20:01 +00:00
|
|
|
|
|
|
|
|
|
|
## 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.
|
2026-01-26 13:04:18 +00:00
|
|
|
|
- Secure default: keep the Gateway on loopback and access it via SSH tunnel or Tailscale Serve.
|
|
|
|
|
|
If you bind to `lan`/`tailnet`, require `gateway.auth.token` or `gateway.auth.password`.
|
2026-01-25 00:20:01 +00:00
|
|
|
|
|
|
|
|
|
|
Remote access: [Gateway remote](/gateway/remote)
|
|
|
|
|
|
Platforms hub: [Platforms](/platforms)
|
|
|
|
|
|
|
2026-02-24 01:02:06 +00:00
|
|
|
|
## Shared company agent on a VPS
|
|
|
|
|
|
|
|
|
|
|
|
This is a valid setup when the users are in one trust boundary (for example one company team), and the agent is business-only.
|
|
|
|
|
|
|
|
|
|
|
|
- Keep it on a dedicated runtime (VPS/VM/container + dedicated OS user/accounts).
|
|
|
|
|
|
- Do not sign that runtime into personal Apple/Google accounts or personal browser/password-manager profiles.
|
|
|
|
|
|
- If users are adversarial to each other, split by gateway/host/OS user.
|
|
|
|
|
|
|
|
|
|
|
|
Security model details: [Security](/gateway/security)
|
|
|
|
|
|
|
2026-01-25 00:20:01 +00:00
|
|
|
|
## 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)
|
2026-03-01 12:28:06 -08:00
|
|
|
|
|
|
|
|
|
|
## Startup tuning for small VMs and ARM hosts
|
|
|
|
|
|
|
|
|
|
|
|
If CLI commands feel slow on low-power VMs (or ARM hosts), enable Node's module compile cache:
|
|
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
|
grep -q 'NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache' ~/.bashrc || cat >> ~/.bashrc <<'EOF'
|
|
|
|
|
|
export NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
|
|
|
|
|
|
mkdir -p /var/tmp/openclaw-compile-cache
|
|
|
|
|
|
export OPENCLAW_NO_RESPAWN=1
|
|
|
|
|
|
EOF
|
|
|
|
|
|
source ~/.bashrc
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
- `NODE_COMPILE_CACHE` improves repeated command startup times.
|
|
|
|
|
|
- `OPENCLAW_NO_RESPAWN=1` avoids extra startup overhead from a self-respawn path.
|
|
|
|
|
|
- First command run warms cache; subsequent runs are faster.
|
|
|
|
|
|
- For Raspberry Pi specifics, see [Raspberry Pi](/platforms/raspberry-pi).
|
