Home

BotFleet Wiki

Open-source control plane for Discord bot fleets.

BotFleet manages white-label Discord bots, worker processes, shards, health checks, logs, alerts, and customer plan limits from one dashboard. Repo: https://github.com/timeout187/botfleet

This wiki mirrors the docs/*.md files in the repository, which are the source of truth - if the two ever disagree, trust the repo. Everything described here is real and verified against a running instance; nothing is aspirational marketing copy.

Pages

• Getting Started - clone, configure, run, seed
• Architecture - layers, data model, auth model
• Security - token vault, authZ, CSP, known accepted risk
• API Reference - every admin/customer route
• Roadmap - shipped / next / explicitly out of scope

Status at a glance

Built and verified: encrypted token vault (AES-256-GCM), full Prisma/ Postgres data model, Discord OAuth admin login, full admin + customer API layer, complete dashboard UI (Fleet Overview, Bots, Workers, Customers, Logs, Alerts, Security Center, Deployments, Status), plan/limit enforcement, Docker Compose + production Dockerfile, mock-data seed script, a first-run setup wizard (/setup), an admin-promotion UI, and a real worker-rebalancing recommendation engine.

Explicitly stubbed: bot start/stop/restart update status in the database through a RunnerAdapter interface but don't yet control a real process - see lib/runner/pm2-adapter.ts for the exact TODO(real-runner) markers.

Not built yet: a plugin system and an AI worker queue - see Roadmap.