Install EMQX on CentOS/RHEL

This page guides you on installing and starting EMQX on CentOS/RHEL system.

Supported versions:

• Amazon Linux 2023
• Amazon Linux 2
• Rocky Linux 9 (RHEL 9)
• Rocky Linux 8 (RHEL 8)
• CentOS 7 (RHEL 7)

The following sections demonstrate how to download the latest version of EMQX for installation on the CentOS 8 system as an example. For installation on other systems or to install other versions, visit the EMQX Enterprise download site for detailed information.

Install with rpm

1. Go to the official download page and select the CentOS/RHEL tab.
2. Select the latest version 5.8.3. From the Package Type dropdown, select the RHEL 8 (CentOS 8) amd64 or RHEL 8 (CentOS 8) arm64 -> rpm package according to the required CPU architecture.
3. Click the link below for downloading. You can also follow the command-line guide steps for downloading and installing.

Start EMQX

Start EMQX as a systemd service.

sudo systemctl start emqx

Uninstall EMQX

To uninstall EMQX, run:

sudo yum remove emqx

Install with tar.gz

1. Go to the official download page and select the CentOS/RHEL tab.
2. Select the latest version 5.8.3. From the Package Type dropdown, select the RHEL 8 (CentOS 8) amd64 or RHEL 8 (CentOS 8) arm64 -> tar.gz package according to the required CPU architecture.
3. Click the link below for downloading. You can also follow the command-line guide steps for downloading and installing.

Start EMQX

After the installation, run the command below to start EMQX.

./emqx/bin/emqx foreground