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:

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

  2. Install EMQX:

    1. sudo yum install emqx -y

  3. Start EMQX:

    1. 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 pageCentOS/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.rpmCentOS/RHEL - 图2 (opens new window).

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

  2. Install EMQX.

    1. sudo yum install emqx-5.1.0-el8-amd64.rpm -y

  3. Download emqx-5.1.0-el8-arm64.rpmCentOS/RHEL - 图3 (opens new window).

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

  4. Install EMQX.

    1. 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:

    1. $ emqx start
    2. EMQX 5.1.0 is started successfully!
    4. $ emqx_ctl status
    5. Node 'emqx@127.0.0.1' 5.1.0 is started

  • To start EMQX with systemctl, run:

    1. sudo systemctl start emqx

  • To start EMQX as a service, run:

    1. sudo service emqx start

Uninstall EMQX

To uninstall EMQX, run:

  1. 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.gzCentOS/RHEL - 图4 (opens new window).

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

  2. Install EMQX.

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

  3. Download emqx-5.1.0-el8-arm64.tar.gzCentOS/RHEL - 图5 (opens new window).

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

  4. Install EMQX.

    1. 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.

  1. ./emqx/bin/emqx start