> ## Documentation Index
> Fetch the complete documentation index at: https://docs.botmux.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Docker

> Run BotMux with Docker and Docker Compose

## Docker Compose (Recommended)

```bash theme={null}
TELEGRAM_BOT_TOKEN="YOUR_TOKEN" docker compose up -d
```

## Docker Run

```bash theme={null}
docker run -d -p 8080:8080 -v botmux-data:/data \
  -e TELEGRAM_BOT_TOKEN="YOUR_TOKEN" ghcr.io/skrashevich/botmux:main
```

Data is stored in the `/data` volume inside the container.

## Build Locally

```bash theme={null}
# Standard build
docker build -t botmux .

# Multi-arch build
docker buildx build --platform linux/amd64,linux/arm64 -t botmux .
```

## Environment Variables

| Variable             | Description                              |
| -------------------- | ---------------------------------------- |
| `TELEGRAM_BOT_TOKEN` | Bot token (alternative to `-token` flag) |
| `TELEGRAM_API_URL`   | Custom Telegram API URL                  |
| `DEMO_MODE`          | Set to `true` for demo mode              |