Self-host EMQX on a VPS
A scalable MQTT broker for IoT and smart home devices with a web dashboard.
levelrail-cli templates install emqx --name my-emqxSpecification
- Status
- Listed
- Category
- Infrastructure
- Services
- emqx
- Ports
- 18083, 1883
- Volumes
- 2
- Memory
- about 1 GiB
- arm64
- unknown
- amd64
- unknown
- Settings to fill in
- none
- License
- Source available, BUSL-1.1
- Listing
- Community template
About EMQX
A scalable MQTT broker for IoT and smart home devices with a web dashboard.
What it deploys
EMQX runs as one service in a single Compose app, listening on ports 18083, 1883, with 2 named volume mounts.
| Service | Image | Tag | Ports | Volumes |
|---|---|---|---|---|
| emqx | emqx/emqx | 6.3.2 | 18083, 1883 | data -> /opt/emqx/datalog -> /opt/emqx/log |
Before you install
- CPU architecture. arm64 unknown. The scan could not read a manifest or the tag is chosen at install time. This is not a claim either way.
- Listed. It is in the catalog. Back up the data volume before changing an image tag.
Settings and environment
You do not have to fill in anything. 1 secret is generated at deploy and stored encrypted. Values are never shown here.
| Service | Variable | Value |
|---|---|---|
| emqx | EMQX_DASHBOARD__DEFAULT_PASSWORD | Generated at deploy |
First run
- Sign in as admin with the generated password. Devices reach the broker at emqx:1883 inside the project network.
Install EMQX on a VPS
-
Install Levelrail on a fresh VPS
Run this as root on a Linux server (amd64 or arm64) with ports 80 and 443 reachable. The installer prints a setup link.
curl -fsSL https://levelrail.com/install.sh | sudo sh -
Sign in
Open the setup link, choose a password, then log the CLI in. The CLI install command is
curl -fsSL https://levelrail.com/install-cli.sh | shif the machine does not have it. See Getting started.levelrail-cli login --device -
Read the template
Shows the entry, including its full compose.yaml.
levelrail-cli templates get emqx -
Install it
This template has an install form, so the CLI fills each setting from --env, a generated secret or its default.
levelrail-cli templates install emqx --name my-emqxTo put a service behind a domain at install, add
--domain SERVICE=HOST:levelrail-cli templates install emqx --name my-emqx --domain emqx=emqx.example.com
Without a domain the app gets an sslip.io address. You can also deploy it from the dashboard: Apps, New app, Browse templates, then EMQX.
Docs and upstream
More in Infrastructure
- Envoy ProxyCloud native edge and service proxy on the official image. The install form carries envoy.yaml as an editable file, so it starts with a working listener instead of exiting on a missing config.
- etcdA distributed key-value store for configuration and coordination, running as a single member.
- ElasticsearchA distributed, RESTful search and analytics engine for full-text search and log analytics. Security is off, so reach it from other services in this project at elasticsearch:9200, or attach a domain only behind Basic Auth. Not published on the host.
- ConsulHashiCorp Consul in single-server mode with the web UI: service discovery, health checks and a key-value store.
- Cloudflare DDNSKeeps Cloudflare DNS records pointed at your current public IP address.
- ChiselA fast TCP and UDP tunnel over HTTP secured by SSH, for reaching services behind firewalls. MIT licensed. The tunnel password is generated for you.