diff --git a/docs/install/docker.md b/docs/install/docker.md
index 5647ad87b..1c47cb57b 100644
--- a/docs/install/docker.md
+++ b/docs/install/docker.md
@@ -9,6 +9,12 @@ read_when:
 
 Docker is **optional**. Use it only if you want a containerized gateway or to validate the Docker flow.
 
+## Is Docker right for me?
+
+- **Yes**: you want an isolated, throwaway gateway environment or to run Clawdbot on a host without local installs.
+- **No**: you’re running on your own machine and just want the fastest dev loop. Use the normal install flow instead.
+- **Sandboxing note**: agent sandboxing uses Docker too, but it does **not** require the full gateway to run in Docker. See [Sandboxing](/gateway/sandboxing).
+
 This guide covers:
 - Containerized Gateway (full Clawdbot in Docker)
 - Per-session Agent Sandbox (host gateway + Docker-isolated agent tools)
@@ -35,6 +41,11 @@ This script:
 - runs the onboarding wizard
 - prints optional provider setup hints
 - starts the gateway via Docker Compose
+- generates a gateway token and writes it to `.env`
+
+After it finishes:
+- Open `http://127.0.0.1:18789/` in your browser.
+- Paste the token into the Control UI (Settings → token).
 
 It writes config/workspace on the host:
 - `~/.clawdbot/`
diff --git a/docs/platforms/exe-dev.md b/docs/platforms/exe-dev.md
index b2ccae4a9..b07514eb7 100644
--- a/docs/platforms/exe-dev.md
+++ b/docs/platforms/exe-dev.md
@@ -13,6 +13,15 @@ Goal: Clawdbot Gateway running on an exe.dev VM, reachable from your laptop via:
 
 This page assumes **Ubuntu/Debian**. If you picked a different distro, map packages accordingly.
 
+If you’re on any other Linux VPS, the same steps apply — you just won’t use the exe.dev proxy commands.
+
+## Beginner quick path
+
+1) Create VM → install Node 22 → install Clawdbot  
+2) Run `clawdbot onboard --install-daemon`  
+3) Tunnel from laptop (`ssh -N -L 18789:127.0.0.1:18789 …`)  
+4) Open `http://127.0.0.1:18789/` and paste your token
+
 ## What you need
 
 - exe.dev account + `ssh exe.dev` working on your laptop
diff --git a/docs/platforms/linux.md b/docs/platforms/linux.md
index 78cd062c6..e83f9db4e 100644
--- a/docs/platforms/linux.md
+++ b/docs/platforms/linux.md
@@ -10,6 +10,16 @@ Clawdbot core is fully supported on Linux. The core is written in TypeScript, so
 
 We do not have a Linux companion app yet. It is planned, and we would love contributions to make it happen.
 
+## Beginner quick path (VPS)
+
+1) Install Node 22+  
+2) `npm i -g clawdbot@latest`  
+3) `clawdbot onboard --install-daemon`  
+4) From your laptop: `ssh -N -L 18789:127.0.0.1:18789 <user>@<host>`  
+5) Open `http://127.0.0.1:18789/` and paste your token
+
+Step-by-step VPS guide: [exe.dev](/platforms/exe-dev)
+
 ## Install
 - [Getting Started](/start/getting-started)
 - [Install & updates](/install/updating)