chapsaldduk/oh-my-mqtt repository overview

⁠Oh My MQTT

A modern, high-performance MQTT client that runs in your browser. Monitor topics in real time, record message sessions, and export everything as JSON — across multiple simultaneous connections.

⁠Quick Start

docker run -d -p 3000:3000 chapsaldduk/oh-my-mqtt

Open http://localhost:3000⁠

⁠Supported Architectures

Multi-arch images are provided. Docker automatically pulls the correct image for your platform.

⁠Key Features

• Multi-Connection Tabs — Connect to multiple MQTT brokers at once, each in its own tab
• Connection Import / Export — Save and share connection profiles as JSON
• Message Download — Export received messages as JSON for analysis or archiving
• Session Recording — Capture all messages within a time window and download them as JSON
• Topic Tree Browser — Visualize your MQTT topic hierarchy in real time
• Message Viewer — Inspect payloads in JSON, Plain Text, HEX, or Base64
• Publish Messages — Send messages with QoS and Retain options
• Advanced Search — Filter by regex, topic pattern, or time range
• Statistics Dashboard — View message rates, per-topic stats, and QoS distribution

⁠Supported Protocols

All MQTT protocols are supported through a built-in WebSocket-to-TCP proxy:

⁠Docker Compose

services:
  oh-my-mqtt:
    image: chapsaldduk/oh-my-mqtt
    ports:
      - "3000:3000"
    restart: unless-stopped

docker compose up -d

⁠Environment Variables

⁠Why Docker?

The macOS desktop app is not code-signed, so Gatekeeper blocks direct .dmg installs. The Docker version bypasses this entirely — no signing, no workarounds, just docker run.

⁠Source Code

github.com/chapsaldduk/oh-my-mqtt⁠

⁠License

MIT