> ## Documentation Index
> Fetch the complete documentation index at: https://docs.levelrail.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Self-host EMQX with Docker

> A scalable MQTT broker for IoT and smart home devices with a web dashboard.

A scalable MQTT broker for IoT and smart home devices with a web dashboard.

This page describes the Levelrail template for EMQX (Infrastructure). It deploys the services below as one Docker Compose app on your own server. Project site: [https://docs.emqx.com/en/emqx/latest/](https://docs.emqx.com/en/emqx/latest/).

Recommended memory: about 1024 MiB.

## Services, ports and volumes

| Service | Image | Container ports | Volumes |
| - | - | - | - |
| `emqx` | `emqx/emqx:6.3.2` | 18083, 1883 | `data -&#62; /opt/emqx/data` `log -&#62; /opt/emqx/log` |

## Environment variables

| Service | Variable | Value |
| - | - | - |
| `emqx` | `EMQX_DASHBOARD__DEFAULT_PASSWORD` | Generated at deploy |

Passwords and keys marked as generated are created for you when the app is deployed and stored as secrets. Values are not shown here.

## Security and requirements

Level: **Standard**.

What this template needs:

* Passwords and keys are generated at deploy time (`emqx`): EMQX\_DASHBOARD\_\_DEFAULT\_PASSWORD.
* Stores data in named volumes (`emqx`): data, log.

What Levelrail adds around it:

* Automatic HTTPS and an ingress shield in front of every domain.
* Secrets are generated, stored encrypted and masked in logs and the UI.
* Named volumes can be backed up and restored.
* Deploys are gated on the health check before traffic switches.
* One-step rollback to the previous revision.
* Exposure report shows what is reachable from outside.
* Host firewall rules managed for published ports.

## Deploy EMQX with Levelrail

In the dashboard, open **Apps**, choose **New app**, then **Browse templates**, and select EMQX. Review the Compose body and deploy.

With the CLI:

```bash theme={"dark"}
levelrail-cli templates deploy emqx --name my-emqx
```

See the [service template catalog](https://docs.levelrail.com/templates-and-registry.md) for how templates work, and [Getting started](https://docs.levelrail.com/getting-started.md) if you have not installed Levelrail yet.

## More Infrastructure templates

* [ActiveMQ Classic](https://docs.levelrail.com/self-host/activemq.md)
* [AdGuard Home](https://docs.levelrail.com/self-host/adguard-home.md)
* [Caddy](https://docs.levelrail.com/self-host/caddy.md)
* [Chisel](https://docs.levelrail.com/self-host/chisel.md)
* [Cloudflare DDNS](https://docs.levelrail.com/self-host/cloudflare-ddns.md)

All templates are listed in the [self-host gallery](https://docs.levelrail.com/self-host.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.