Skip to content

BunkerM Documentation

Get up and running fast

Everything you need to deploy, configure, and extend BunkerM. One container, one command.

QUICK START

docker run -d -p 1900:1900 -p 2000:2000 bunkeriot/bunkerm:latest

Then open http://localhost:2000 in your browser and set up your first Admin account.

  • Home Assistant

    Run BunkerM as a native Home Assistant add-on.

    Setup guide

  • Slack

    Chat with your broker from any Slack channel.

    Setup guide

  • Telegram

    Control your broker via Telegram bot.

    Setup guide

  • Web Chat

    Use the built-in AI chat directly in the dashboard.

    Open Web Chat

What is BunkerM?

BunkerM is an open-source, containerized MQTT management platform. It bundles Eclipse Mosquitto with a full web dashboard in a single Docker container. No manual broker setup, no juggling separate tools.

With BunkerM you get:

  • A production-ready Mosquitto MQTT broker
  • A web UI for managing clients, roles, groups, and ACLs
  • Real-time monitoring and connection logs
  • A built-in MQTT Browser to explore topics and payloads
  • AI-powered assistance through BunkerAI (optional cloud feature)

BunkerM vs BunkerAI

BunkerM is the open-source core. It gives you a fully functional Mosquitto MQTT broker with a web management interface. You can create clients, define ACL rules, monitor connections, browse topics, and configure the broker - all from a browser. BunkerM works completely standalone without any cloud dependency or account required.

BunkerAI is an optional cloud-connected layer that adds AI capabilities on top of BunkerM. When you connect your BunkerM instance to BunkerAI Cloud from Settings > Integrations, you unlock:

  • A conversational AI assistant that lets you control your broker in plain language
  • Automated watchers that monitor topics and trigger actions when conditions are met
  • Scheduled jobs that publish messages on a cron schedule
  • Smart anomaly detection and intelligent alerts
  • Multi-channel access via Web Chat, Slack, and Telegram
  • Natural-language ACL management ("create a client called sensor1 with read access to sensor/#")

BunkerAI uses AI to give you full natural-language control over your Mosquitto broker, including ACL management. All BunkerAI features are surfaced in the BunkerM dashboard once you connect. BunkerM remains fully functional without BunkerAI - the AI layer is additive, not required.

Running BunkerM with Persistent Data

Basic (data lost on restart)

docker run -d -p 1900:1900 -p 2000:2000 bunkeriot/bunkerm:latest

This is fine for evaluation but your MQTT clients, ACL rules, and web UI accounts will be lost when the container stops.

docker run -d \
  -p 1900:1900 \
  -p 2000:2000 \
  -v bunkerm_data:/nextjs/data \
  -v mosquitto_data:/var/lib/mosquitto \
  -v mosquitto_conf:/etc/mosquitto \
  --name bunkerm \
  bunkeriot/bunkerm:latest

What each volume stores:

Volume Contents
bunkerm_data Web UI user accounts, BunkerAI settings, agent data, anomaly history, API keys
mosquitto_data MQTT persistence files, dynamic security (clients, ACLs, roles, groups)
mosquitto_conf Mosquitto broker configuration files 
version: "3.8"
services:
  bunkerm:
    image: bunkeriot/bunkerm:latest
    ports:
      - "1900:1900"
      - "2000:2000"
    volumes:
      - bunkerm_data:/nextjs/data
      - mosquitto_data:/var/lib/mosquitto
      - mosquitto_conf:/etc/mosquitto
    restart: unless-stopped

volumes:
  bunkerm_data:
  mosquitto_data:
  mosquitto_conf:

Save this as docker-compose.yml and run:

docker compose up -d

See Running BunkerM with Persistent Storage for full details including backup strategies and upgrade procedures.

Documentation Sections

Getting Started

User Guide

Integrations