From 0aa48a26d1545aca659251b84d7401229612a3fc Mon Sep 17 00:00:00 2001
From: adeboyedn <adeboyed93@gmail.com>
Date: Mon, 26 Jan 2026 08:07:33 +0100
Subject: [PATCH] docs: add Northflank deployment guide for Clawdbot

---
 docs/docs.json          |  4 ++++
 docs/help/faq.md        |  2 ++
 docs/northflank.mdx     | 51 +++++++++++++++++++++++++++++++++++++++++
 docs/platforms/index.md |  2 ++
 docs/vps.md             |  2 ++
 5 files changed, 61 insertions(+)
 create mode 100644 docs/northflank.mdx

diff --git a/docs/docs.json b/docs/docs.json
index 2cc5ae78b..12c6cc36b 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -805,6 +805,10 @@
       "source": "/install/railway/",
       "destination": "/railway"
     },
+    {
+      "source": "/install/northflank/",
+      "destination": "/northflank"
+    },
     {
       "source": "/gcp",
       "destination": "/platforms/gcp"
diff --git a/docs/help/faq.md b/docs/help/faq.md
index 336b324c9..165895e53 100644
--- a/docs/help/faq.md
+++ b/docs/help/faq.md
@@ -566,6 +566,8 @@ 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)
+- [Northflank](/northflank) (one‑click, browser‑based setup)
 - [Fly.io](/platforms/fly)
 - [Hetzner](/platforms/hetzner)
 - [exe.dev](/platforms/exe-dev)
diff --git a/docs/northflank.mdx b/docs/northflank.mdx
new file mode 100644
index 000000000..1a53bf2fe
--- /dev/null
+++ b/docs/northflank.mdx
@@ -0,0 +1,51 @@
+---
+title: Deploy on Northflank
+---
+
+Deploy Clawdbot on Northflank with a one-click template and finish setup in your browser.
+This is the easiest “no terminal on the server” path: Northflank runs the Gateway for you,
+and you configure everything via the `/setup` web wizard.
+
+## How to get started
+
+1. Click [Deploy Clawdbot](https://northflank.com/stacks/deploy-clawdbot) to open the template.  
+2. Create an [account on Northflank](https://app.northflank.com/signup) if you don’t already have one.  
+3. Click **Deploy Clawdbot now**.  
+4. Set the required environment variable: `SETUP_PASSWORD` 
+5. Click **Deploy stack** to build and run the Clawdbot template.  
+6. Wait for the deployment to complete, then click **View resources**.  
+7. Open the Clawdbot service.  
+8. Open the public Clawdbot URL and complete setup at `/setup`.
+
+## What you get
+
+- Hosted Clawdbot Gateway + Control UI
+- Web setup wizard at `/setup` (no terminal commands)
+- Persistent storage via Northflank Volume (`/data`) so config/credentials/workspace survive redeploys
+
+## Setup flow
+
+1) Visit `https://<your-northflank-domain>/setup` and enter your `SETUP_PASSWORD`.
+2) Choose a model/auth provider and paste your key.
+3) (Optional) Add Telegram/Discord/Slack tokens.
+4) Click **Run setup**.
+
+If Telegram DMs are set to pairing, the setup wizard can approve the pairing code.
+
+## Getting chat tokens
+
+### Telegram bot token
+
+1) Message `@BotFather` in Telegram
+2) Run `/newbot`
+3) Copy the token (looks like `123456789:AA...`)
+4) Paste it into `/setup`
+
+### Discord bot token
+
+1) Go to https://discord.com/developers/applications
+2) **New Application** → choose a name
+3) **Bot** → **Add Bot**
+4) **Enable MESSAGE CONTENT INTENT** under Bot → Privileged Gateway Intents (required or the bot will crash on startup)
+5) Copy the **Bot Token** and paste into `/setup`
+6) Invite the bot to your server (OAuth2 URL Generator; scopes: `bot`, `applications.commands`)
diff --git a/docs/platforms/index.md b/docs/platforms/index.md
index 3a1e87267..69b37090e 100644
--- a/docs/platforms/index.md
+++ b/docs/platforms/index.md
@@ -24,6 +24,8 @@ 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)
+- Northflank (one-click): [Northflank](/northflank)
 - Fly.io: [Fly.io](/platforms/fly)
 - Hetzner (Docker): [Hetzner](/platforms/hetzner)
 - GCP (Compute Engine): [GCP](/platforms/gcp)
diff --git a/docs/vps.md b/docs/vps.md
index 192ab830e..08910733f 100644
--- a/docs/vps.md
+++ b/docs/vps.md
@@ -11,6 +11,8 @@ deployments work at a high level.
 
 ## Pick a provider
 
+- **Railway** (one‑click + browser setup): [Railway](/railway)
+- **Northflank** (one‑click + browser setup): [Northflank](/northflank)
 - **Oracle Cloud (Always Free)**: [Oracle](/platforms/oracle) — $0/month (Always Free, ARM; capacity/signup can be finicky)
 - **Fly.io**: [Fly.io](/platforms/fly)
 - **Hetzner (Docker)**: [Hetzner](/platforms/hetzner)