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 EMQX:

   sudo yum install emqx -y
   

3. 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 (opens new window).

1. Download emqx-5.2.1-el8-amd64.rpm (opens new window).

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

2. Install EMQX.

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

1. Download emqx-5.2.1-el8-arm64.rpm (opens new window).

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

2. Install EMQX.

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

Start EMQX

EMQX offers 3 different options to start EMQX:

• To start EMQX directly, run:

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

• To start EMQX with systemctl, run:

  sudo systemctl start emqx
  

• To start EMQX as a service, run:

  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 (opens new window).

1. Download emqx-5.2.1-el8-amd64.tar.gz (opens new window).

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

2. Install EMQX.

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

1. Download emqx-5.2.1-el8-arm64.tar.gz (opens new window).

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

2. Install EMQX.

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

Start EMQX

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

./emqx/bin/emqx start