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.

• amd64
• arm64

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

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

2. Install EMQX.

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

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

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

2. Install EMQX.

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

Start EMQX

EMQX offers 3 different options to start EMQX:

• To start EMQX directly, run:

  $ emqx start
  EMQX 5.1.6 is started successfully!
  
  $ emqx ctl status
  Node 'emqx@127.0.0.1' 5.1.6 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.

• amd64
• arm64

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

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

2. Install EMQX.

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

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

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

2. Install EMQX.

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

Start EMQX

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

./emqx/bin/emqx start