Skip to content

EMQX MQTT Broker Installation Fails

DodaTech Updated 2026-06-26 1 min read

In this tutorial, you'll learn about EMQX MQTT Broker Installation Fails. We cover key concepts, practical examples, and best practices.

The Problem

EMQX installation fails on Linux due to missing dependencies or incorrect repository setup.

Quick Fix

Wrong

sudo apt-get install emqx  # Package not in default repos
E: Package 'emqx' has no installation candidate.
curl -s https://packages.emqx.io/emqx/emqx-5.0/emqx-5.0.26-ubuntu20.04-amd64.deb -o emqx.deb
sudo dpkg -i emqx.deb
sudo apt-get install -f  # Fix dependencies
sudo systemctl start emqx
sudo systemctl status emqx
emqx.service - EMQX MQTT Broker loaded active running.

Prevention

Add the official EMQX repository for apt-based installs. For Docker: docker run -d --name emqx -p 1883:1883 -p 8083:8083 -p 8084:8084 -p 8883:8883 -p 18083:18083 emqx/emqx:latest. Check system requirements: 2 GB RAM, 2 cores, Linux x86_64. Verify with curl http://localhost:18083/api/v5/broker/status.

DodaTech engineers apply these same patterns across Doda Browser, DodaZIP, and Durga Antivirus Pro for production IoT reliability.

FAQ

### What ports does EMQX use?

1883 (MQTT), 8883 (MQTTS), 8083 (WS), 8084 (WSS), 18083 (Dashboard API), 4369 (Distributed Erlang), 5370 (Cluster).

Can I install EMQX on Docker?

Yes. Docker is the recommended deployment method. Use the official image emqx/emqx:latest or a specific version tag.

What is the default admin password?

Default: admin / public. Change immediately via Dashboard or emqx.conf.

Built by the developers of DodaTech

Doda Browser, DodaZIP & Durga Antivirus Pro