CentOS/RHEL

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
  1. Install EMQX:
sudo yum install emqx -y
  1. 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 CentOS/RHEL - 图1 (opens new window).

Install with rpm

EMQX offers different installation packages for different CPU architectures.

  1. Download emqx-5.1.0-el8-amd64.rpm CentOS/RHEL - 图2 (opens new window).
wget https://www.emqx.com/en/downloads/broker/5.1.0/emqx-5.1.0-el8-amd64.rpm
  1. Install EMQX.
sudo yum install emqx-5.1.0-el8-amd64.rpm -y
  1. Download emqx-5.1.0-el8-arm64.rpm CentOS/RHEL - 图3 (opens new window).
wget https://www.emqx.com/en/downloads/broker/5.1.0/emqx-5.1.0-el8-arm64.rpm
  1. Install EMQX.
sudo yum install emqx-5.1.0-el8-arm64.rpm -y

Start EMQX

EMQX offers 3 different options to start EMQX:

  • To start EMQX directly, run:
$ emqx start
EMQX 5.1.0 is started successfully!

$ emqx_ctl status
Node 'emqx@127.0.0.1' 5.1.0 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.

  1. Download emqx-5.1.0-el8-amd64.tar.gz CentOS/RHEL - 图4 (opens new window).
wget https://www.emqx.com/en/downloads/broker/5.1.0/emqx-5.1.0-el8-amd64.tar.gz
  1. Install EMQX.
mkdir -p emqx && tar -zxvf emqx-5.1.0-el8-amd64.tar.gz -C emqx
  1. Download emqx-5.1.0-el8-arm64.tar.gz CentOS/RHEL - 图5 (opens new window).
wget https://www.emqx.com/en/downloads/broker/5.1.0/emqx-5.1.0-el8-arm64.tar.gz
  1. Install EMQX.
mkdir -p emqx && tar -zxvf emqx-5.1.0-el8-arm64.tar.gz -C emqx

Start EMQX

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

./emqx/bin/emqx start