Setup guide

Setting up your OfficeForge office

One command on your own server, a short wizard, and your AI team is live. About 10–15 minutes — most of it is the installer working while you grab a coffee.

officeforge.co · self-hosted AI team for business

Before you start

  • A clean Linux server (VPS) with root / sudo access. Ubuntu/Debian, at least 8 GB RAM, 4 CPU and 60 GB disk (16 GB / 8 CPU recommended) — the full stack (Docker + Plane + agents) needs it; 4 GB will OOM. Popular providers: Hetzner Cloud · DigitalOcean · Vultr.
  • Your LLM API key — you pay the model provider directly; OfficeForge doesn't resell tokens. Get one from OpenRouter (sk-or-…, recommended — one key, all models), Anthropic/Claude (sk-ant-…), OpenAI (sk-…) or xAI/Grok (xai-…). It also supports Xiaomi MiMo — a huge 1M-token context and very cost-effective for coding-heavy work.
  • Your license key — the ofs1.… code from your purchase email (also shown below).
⚡ Flat subscriptions, not just API keys. OfficeForge can also drive agents from your own flat-rate plans (ChatGPT Plus, Claude Max, xAI and similar) instead of pay-per-token keys. Whether automated use of an interactive subscription is allowed is governed by that provider's own terms — using it that way is your responsibility. OfficeForge only provides the capability; complying with each provider's terms of service is on you.
A domain is optional — the box gets a free address automatically. Want TLS on your own hci.<you> / plane.<you>? Point a domain at the server and the engineer sets it up with you later in chat. Your LLM key is added the same way — after install, in chat or the AI Subs tab.

1 Run the installer

SSH into your server and run this single command. It installs Docker if needed, then starts the wizard.

curl -fsSL https://officeforge.co/install.sh | sudo bash

2 Enter your license key — the only question

That's it. Paste your ofs1.… key (shown below) and the installer takes over — it provisions a free address, brings the whole stack up, and wakes your setup engineer. No LLM key, domain, company details, language or passwords to type here — you do all of that afterwards, in a simple chat.

If you designed your team first with the free AI Team Builder (same email as your purchase), the box installs already configured to match — roles, per-role models and your company profile are applied automatically.

3 Finish in the operator console

When the installer finishes it prints your live URLs (operator console, task board, office site). Open the operator console, create your admin login, then say hello to the engineer agent — it finishes everything with you in chat: your LLM key, a model per role, your company profile, a custom domain if you want one, Telegram bots and optional email. No terminal needed. (You can also drop in your key yourself under AI Subs in the console.)

Your office stays asleep (no model spend) until you send that first message — an installed-but-unconfigured box costs nothing.

Verify everything is up

  • All URLs open over https (valid certificate).
  • The agents reply in the console chat.
  • A test task moves assigned → review → done.

Your license key

Paste this into the wizard's first question:

Open this page from your purchase email to see your key here — or copy it from that email.

Stuck on any step? Reply to your purchase email or write [email protected].