Quick Start (Docker)

Getting Started

Quick Start (Docker)

Run FluxMQ with Docker Compose or docker run using the provided config

Quick Start (Docker)

Last Updated: 2026-02-25

Option 1: Docker Compose (Recommended)

Run from the repo root so paths resolve correctly:

docker compose -f deployments/docker/compose.yaml up -d

Use a custom config (example):

FLUXMQ_CONFIG=../examples/no-cluster.yaml \
  docker compose -f deployments/docker/compose.yaml up -d

Option 2: Docker Run

docker run --rm \
  -p 1883:1883 \
  -p 1884:1884 \
  -p 8083:8083 \
  -p 8080:8080 \
  -p 5672:5672 \
  -p 5682:5682 \
  -p 8081:8081 \
  -v "$(pwd)/deployments/docker/config.yaml:/etc/fluxmq/config.yaml:ro" \
  -v fluxmq-data:/var/lib/fluxmq \
  ghcr.io/absmach/fluxmq:latest \
  --config /etc/fluxmq/config.yaml

The default Docker config uses dedicated TCP listeners:

1883/tcp: MQTT v3 (server.tcp.v3)
1884/tcp: MQTT v5 (server.tcp.v5)

Next Steps

FluxMQ Documentation

Welcome to FluxMQ - a high-performance, multi-protocol message broker with MQTT, WebSocket, HTTP, and CoAP support

First Message

Publish and subscribe to your first MQTT topic