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.

Most teams should start here.

  1. Download the mobile or desktop app.
  2. Create a bot token — token setup guide.
  3. Design commands in the visual editor or JavaScript blocks.
  4. 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