Install EMQX on CentOS/RHEL
This page guides you on installing and starting the EMQX Open Source edition 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)
Install with Yum Source
EMQX supports installing with Yum source to provide our users with a convenient and reliable way to manage EMQX installation and updates. Here is how to install EMQX with Yum source:
Download the EMQX repository:
bashcurl -s https://assets.emqx.com/scripts/install-emqx-rpm.sh | sudo bash
Install the following dependencies:
bashyum install epel-release -y yum install -y openssl11 openssl11-devel
Install EMQX:
bashsudo yum install emqx -y
Start EMQX:
bashsudo systemctl start emqx
Install with rpm
EMQX offers rpm installation packages for different CPU architectures.
This section demonstrates 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 Open Source download site for detailed installation information.
- Go to the official download page and select the CentOS/RHEL tab. Then, select Package.
- Select the latest version
5.8.0
. From the Package Type dropdown, select theRHEL 8 (CentOS 8) amd64
orRHEL 8 (CentOS 8) arm64
->rpm
package according to the required CPU architecture. - 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
EMQX offers tar.gz installation packages for different CPU architectures.
This section demonstrates 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 Open Source download site for detailed installation information.
- Go to the official download page and select the CentOS/RHEL tab. Then, select Package.
- Select the latest version
5.8.0
. From the Package Type dropdown, select theRHEL 8 (CentOS 8) amd64
orRHEL 8 (CentOS 8) arm64
->tar.gz
package according to the required CPU architecture. - 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