Install
Two accounts, one button, one paste. Deploy the backend to your own Cloudflare with a single click, then paste one line to wire it into Goose. No API token, no Docker — just a card on your Cloudflare account (usage stays free-tier).
0 What you'll need
Need — before you start:
- A Cloudflare account and a GitHub account (sign-ups, not installs) — the button puts your own copy of the backend on GitHub and deploys it to your Cloudflare. Can't set those up? Ask whoever looks after your tech to run this once — it's a five-minute job for them.
- A payment method on your Cloudflare account — Cloudflare asks for a card to switch on R2 (your cortex storage) and Browser Rendering. Normal use stays inside the free tiers (~$0 at typical volume), so you're enabling the services, not committing to a bill — but the card is required before the deploy will work.
- Goose Desktop — the local agent runtime the town's interactive apps run inside.
- A model for Goose to think with — open Goose's settings and add a provider; an OpenRouter API key is the easy pick (one key, every model). Without it the final "hi" has nothing to answer with.
- The Goose CLI — you don't install this yourself; the connect step adds it for you (it runs the background cron + workflows).
Nice to have — handy once you're working, add any time:
- Obsidian or VS Code — your cortex is plain markdown in
~/OfficeTown/, so edit it in a real editor.
- OfficeCLI — read & write Word, Excel and PowerPoint (just ask your agent to add it).
- The Cloudflare role pack — manage DNS, R2 and D1 from inside Goose.
- Browser automation + web-search Goose extensions — give the agent more reach online.
- Docker — only if you want the optional cloud code sandbox (most people don't).
Get Goose →
1 Deploy the backend — one click
Click the button. Cloudflare signs you in, clones the backend to your GitHub, provisions D1 + R2 + Vectorize + Queue + Workers AI, and deploys it — all on Cloudflare's own build infra, so no API token and no Docker.
Two fields to fill in the deploy form: Vectorize Dimensions 768 and Metric cosine. Leave everything else blank — the worker mints its own access token on first run. ~2-3 minutes later you'll have your worker URL.
No custom domain needed. If you spot a "from email" field, just leave the default — sending email is the only feature that uses a domain, and you can add one and change the address later. Everything else works without it.
Make sure you've added a payment method to Cloudflare first (it's needed to enable R2 + Browser Rendering — see Step 0); otherwise the deploy stops partway. Usage sits inside the free tiers at normal volume. The optional cloud code sandbox is the one feature that needs the full Workers Paid plan on top — most people skip it.
2 Wire it into Goose — one paste
Open <your-worker-url>/dashboard/connect, click Claim this install, then copy the pre-filled one-liner and paste it into a terminal. It bootstraps the Goose CLI if needed, wires the MCPs into Goose, installs the officetowd sync daemon, and creates your town at ~/OfficeTown/ — complete with your team, the wiki, and the workflows, ready to open in Goose.
✓ Then just say hi
Quit and reopen Goose Desktop so it loads the new extensions, open it in your ~/OfficeTown folder (that's where your team lives — open it anywhere else and they won't show), and type "hi" — an agent welcomes you and offers a few ways to start. The fastest: drop a pile of your real documents into ~/OfficeTown/inbox/ and ask it to go through them. It'll read everything and learn your business.
Prefer an agent to drive the whole thing — or installing onto a client's account headless? Skip the button: wrangler login (or a scoped API token) plus one pasted prompt lets a Goose agent provision and wire everything itself — see the install guide. If the deploy button ever errors with “failed to get repository contents”, use that agent path instead.
