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)

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:

1. Download the EMQX repository:

   curl -s https://assets.emqx.com/scripts/install-emqx-rpm.sh | sudo bash

2. Install the following dependencies:

   yum install epel-release -y
   yum install -y openssl11 openssl11-devel

3. Install EMQX:

   sudo yum install emqx -y

4. Start EMQX:

   sudo systemctl start emqx

Install with rpm

EMQX offers rpm installation packages for different CPU architectures.

This section takes CentOS 8 as an example to illustrate how to download the latest version of EMQX. For other system versions, please visit the EMQX Deployment page.

• amd64
• arm64

1. Download emqx-5.6.1-el8-amd64.rpm.

   wget https://www.emqx.com/en/downloads/broker/5.6.1/emqx-5.6.1-el8-amd64.rpm

2. Install EMQX.

   sudo yum install emqx-5.6.1-el8-amd64.rpm -y

1. Download emqx-5.6.1-el8-arm64.rpm.

   wget https://www.emqx.com/en/downloads/broker/5.6.1/emqx-5.6.1-el8-arm64.rpm

2. Install EMQX.

   sudo yum install emqx-5.6.1-el8-arm64.rpm -y

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 takes CentOS 8 as an example to illustrate how to download the latest version of EMQX. For other versions, please visit the EMQX Deployment page.

• amd64
• arm64

1. Download emqx-5.6.1-el8-amd64.tar.gz.

   wget https://www.emqx.com/en/downloads/broker/5.6.1/emqx-5.6.1-el8-amd64.tar.gz

2. Install EMQX.

   mkdir -p emqx && tar -zxvf emqx-5.6.1-el8-amd64.tar.gz -C emqx

1. Download emqx-5.6.1-el8-arm64.tar.gz.

   wget https://www.emqx.com/en/downloads/broker/5.6.1/emqx-5.6.1-el8-arm64.tar.gz

2. Install EMQX.

   mkdir -p emqx && tar -zxvf emqx-5.6.1-el8-arm64.tar.gz -C emqx

Start EMQX

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

./emqx/bin/emqx foreground