BunkerM - MQTT Made Easy ✅

📋 Table of Contents

• What is BunkerM?
• 💼 Need Custom MQTT Features? Reach Out Today!
• Solution Overview
• Quick Start with Docker
• ⭐ Core Features
  • Broker Dashboard
  • Access Control List (ACL) Management
  • Cloud Integration (Pro Feature)
  • REST API (Coming soon)
  • MQTT Client Management
• 🛠️ Troubleshooting
• ✨ Features
  • Infrastructure & Scaling
  • Core Management
  • Security
  • Cloud & Database Integrations
  • Monitoring & User Management
  • Protocol Support
  • MQTT Features
  • Platform Support
• 💰 Community vs Paid versions
• ❤️ Support BunkerM Project
• 📜 License

🔍 What is BunkerM?

BunkerM is an open-source, containerized MQTT management solution that bundles together a Mosquitto broker with a comprehensive web interface. It provides a complete, ready-to-deploy MQTT environment with built-in management capabilities, eliminating the need for separate broker setup and configuration.

This all-in-one solution features dynamic security controls, real-time monitoring, client activity logging, and cloud integration capabilities. The entire stack - Mosquitto broker, backend services, and frontend UI - comes pre-configured in Docker containers for easy deployment and management.

💼 Need Custom MQTT Features? Reach Out Today!

Website: https://bunkeriot.com
Email me at: [email protected]
Let's connect!

🏗️ Solution Overview

• Mosquitto MQTT Broker (pre-configured)
• Backend Management Services
• Web-based Management Interface
• Dynamic Security Module
• Monitoring and Logging System
• Cloud Bridge Integration (Pro Feature)

🚀 Quick Start with Docker

Get up and running in seconds with BunkerM!

1. Run the Docker Container

Make sure to have Docker installed on your machine before running the command below:

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

This command:

• Runs BunkerM in detached mode (-d)
• Maps the MQTT broker port to 1900 (-p 1900:1900)
• Maps the Web UI port to 2000 (-p 2000:2000)
• Uses the official BunkerM image (bunkeriot/bunkerm)

Persistent Data Deployment

For production environments, you'll want to persist your data across container restarts:

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

This command adds:

• A volume for Mosquitto data (-v mosquitto_data:/var/lib/mosquitto)
• A volume for authentication data (-v auth_data:/data)

Remote Access Installation

If you need to access BunkerM from outside the host machine:

docker run -d -p 1900:1900 -p 2000:2000 \
  -e HOST_ADDRESS=<HOST_IP> \
  bunkeriot/bunkerm

Replace <HOST_IP> with your host machine's IP address or domain name.

2. Access the Interface

• Open your browser and navigate to http://localhost:2000
• The BunkerM web interface will load directly without any security warnings

3. Connect to the MQTT Broker

• Default port: 1900
• Make sure to add a new MQTT client from the UI (Client Accounts menu) to connect to the broker.

⭐ Core Features

Broker Dashboard

Monitor and control MQTT client connections in real-time through the "Recent MQTT Events" dashboard:

• Connected clients count
• Message statistics
• Byte transfer rates
• Subscription tracking
• Retained message counts

🔒 Access Control List (ACL) Management

Manage your MQTT broker's clients:

Client Management

• Create new MQTT clients
• Set client credentials
• Manage client permissions
• Group assignments

Role Management

• Create and configure roles
• Set up ACL rules
• Define topic permissions
• Manage access patterns

Group Management

• Create client groups
• Assign roles to groups
• Manage group members
• Set priorities

☁️ Cloud Integration (Pro Feature)

Connect to major cloud providers:

AWS IoT Core Bridge

• AWS IoT endpoint configuration
• Certificate management
• Topic mapping
• Secure communication

Azure IoT Hub Bridge

• IoT Hub connection setup
• Device authentication
• SAS token management
• Topic routing

🔌 REST API (Coming soon)

👥 MQTT Client Management

This module provides a real-time list of currently connected clients on a node, along with the ability to connect or disconnect an MQTT client using the "Enable" and "Disable" buttons.

🛠️ Troubleshooting

• Verify Docker is running
• Check port availability (2000)
• Monitor Docker logs
• Verify network connectivity
• Check SSL certificate configuration

✨ Features

Infrastructure & Scaling

Core Management

Security

Cloud & Database Integrations

Monitoring & User Management

Protocol Support

MQTT Features

Platform Support

💰 Community vs Paid versions

My mission with BunkerM is to democratize IoT by making MQTT management accessible to everyone. The Community Version is designed to be lightweight, easy to use, and completely free, offering essential features for individuals and small projects.

However, to sustain the development of the Community Version and continue delivering value, I'm introducing Pro and Enterprise Versions. These versions are tailored for businesses and advanced users, offering additional features like:

• Local authentication (no internet required)
• Fine-grained RBAC (Role-Based Access Control)
• LDAP and SSO integrations
• Advanced monitoring and analytics
• Enterprise-grade support

The revenue from the Pro and Enterprise versions will directly support the development and maintenance of the free Community Version. This way, I can keep BunkerM accessible to everyone while also meeting the needs of larger organizations.

If the open-source community shows enough support, I may consider making the Pro version free as well. Your feedback and contributions are invaluable in shaping the future of BunkerM!

❤️ Support BunkerM Project

BunkerM is an open-source project dedicated to making MQTT broker management accessible and secure for everyone. As a solo developer, I've poured countless hours into creating a comprehensive solution that combines the power of Mosquitto with an intuitive management interface, all while keeping it free for non-commercial use.

Your donation helps support:

• Continuous development of new features
• Maintenance and bug fixes
• Documentation improvements
• Community support

Every contribution, no matter the size, helps keep this project active and growing. If you find BunkerM useful in your projects or learning journey, consider supporting its development. Together, we can make IoT and MQTT technology more accessible to developers worldwide.

Thank you for supporting open source! 🙏

📜 License

This project is licensed under the Apache License 2.0. You are free to use, modify, and distribute this software, even for commercial purposes, under the terms of the license.

📜 Full license details: LICENSE
💼 For any inquiries, feel free to reach out: [email protected]