On this page
Meta
Deployment & Hosting
Choose between app hosting and the self-hosted Docker runner for running Bot Creator bots.
Bot Creator supports two deployment models: managed hosting from the app and self-hosted Docker runners.
App hosting (recommended)
Most teams should start here.
- Download the mobile or desktop app.
- Create a bot token — token setup guide.
- Design commands in the visual editor or JavaScript blocks.
- Host directly from the app dashboard.
The app handles uptime, reconnects, and monitoring without server administration.
Docker runner (self-hosted)
Use the Docker runner when you need:
- A browser-based control panel on your own Linux server or Raspberry Pi
- Persistent logs and state in mounted volumes
- Long-lived remote runtime separate from mobile/desktop editing
Quick start
docker pull ghcr.io/ketsuna-org/bot-creator-runner:latest
docker volume create bot-creator-data
docker run -d --name bot-creator-runner \
-p 3000:3000 \
-v bot-creator-data:/data \
ghcr.io/ketsuna-org/bot-creator-runner:latest
Copy commands and version-specific flags from the Download page.
Full runner guide
The complete API and configuration reference is in the Docker Runner (API only) guide, including:
- Environment variables
- Volume layout
- HTTP API endpoints
- Pairing with the mobile/desktop app
Choosing a model
| Need | Recommendation |
|---|---|
| Fast setup, mobile editing | App hosting |
| Team on the go | App hosting |
| Server you already manage | Docker runner |
| Raspberry Pi / homelab | Docker runner |
| Maximum uptime on your infra | Docker runner |
Related documentation
- Getting started — zero-to-first-command path
- Download — app stores and runner setup
- Docker Runner guide — full self-host reference