Codex
50 lines
1.5 KiB
Markdown
50 lines
1.5 KiB
Markdown
# EMQX Ubuntu 24.04 amd64 Install Notes
|
|
|
|
This project uses native Ubuntu packages only. Docker is forbidden.
|
|
|
|
Official references checked on 2026-06-15:
|
|
|
|
- EMQX Ubuntu installation: https://docs.emqx.com/en/emqx/latest/deploy/install-ubuntu.html
|
|
- EMQX file authorization and ACL format: https://docs.emqx.com/en/emqx/latest/access-control/authz/file.html
|
|
|
|
## Preconditions
|
|
|
|
- Ubuntu Server 24.04 x86-64/amd64.
|
|
- Production host: `101.42.38.246`.
|
|
- Ports are restricted by firewall:
|
|
- `1883`: MQTT device access, not open wider than required.
|
|
- `18083`: EMQX dashboard, never open to arbitrary public networks.
|
|
- MQTTX is not installed on the server.
|
|
|
|
## Install
|
|
|
|
EMQX official Ubuntu documentation lists apt installation for Ubuntu 24.04. The administrator must confirm the selected EMQX major version before installing.
|
|
|
|
```bash
|
|
curl -s https://packagecloud.io/install/repositories/emqx/emqx-enterprise5/script.deb.sh | sudo bash
|
|
sudo apt-get install emqx
|
|
sudo systemctl enable --now emqx
|
|
```
|
|
|
|
## Apply ACL Baseline
|
|
|
|
```bash
|
|
sudo install -m 0640 /opt/apps/qipai-repo/deploy/emqx/acl.conf.template /etc/emqx/acl.conf
|
|
sudo install -m 0640 /opt/apps/qipai-repo/deploy/emqx/authorization.hocon.template /etc/emqx/conf.d/qipai-authorization.hocon
|
|
sudo emqx ctl conf reload
|
|
sudo systemctl restart emqx
|
|
```
|
|
|
|
## Check
|
|
|
|
```bash
|
|
emqx version
|
|
systemctl status emqx --no-pager
|
|
ss -ltnp | grep -E ':(1883|18083)\b'
|
|
```
|
|
|
|
## Notes
|
|
|
|
- Device usernames, passwords and client IDs are not stored in Git.
|
|
- M06 will replace the placeholder topic namespace with the final device protocol mapping.
|