CentOS/RHEL

This section guides you on installing and starting EMQX on CentOS/RHEL system.

Supported versions:

• CentOS 8
• CentOS 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 Package

The section below will take 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.

Install with rpm

EMQX offers different installation packages for different CPU architectures.

• amd64
• arm64

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

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

2. Install EMQX.

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

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

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

2. Install EMQX.

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

Start EMQX

EMQX offers 3 different options to start EMQX:

• To start EMQX directly, run:

  $ emqx start
  EMQX 5.0.26 is started successfully!
  
  $ emqx_ctl status
  Node 'emqx@127.0.0.1' 5.0.26 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 apt remove --purge emqx

Install with tar.gz

EMQX offers different installation packages for different CPU architectures.

• amd64
• arm64

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

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

2. Install EMQX.

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

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

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

2. Install EMQX.

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

Start EMQX

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

./emqx/bin/emqx start