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:

   bash

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

2. Install EMQX:

   bash

   sudo yum install emqx -y

3. Start EMQX:

   bash

   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.

Start EMQX ​

EMQX offers 3 different options to start EMQX:

• To start EMQX directly, run:

  bash

  $ emqx start
  EMQX 5.3.2 is started successfully!
  
  $ emqx ctl status
  Node 'emqx@127.0.0.1' 5.3.2 is started

• To start EMQX with systemctl, run:

  bash

  sudo systemctl start emqx

• To start EMQX as a service, run:

  bash

  sudo service emqx start

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.

Start EMQX ​

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

./emqx/bin/emqx start