Install EMQX Enterprise on 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 rpm

1. Go to the official site for EMQX.

2. Select 5.5.1 for Version and CentOS for OS, and click the Download button.

3. On the Downloads and Install page, select rpm as the Install Method and select the proper CPU Architecture that matches your system. Click Download Now.

   You can also follow the command instructions on the page.

Start EMQX

EMQX offers 3 different options to start EMQX:

• To start EMQX directly, run:

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

1. Go to the official site for EMQX.

2. Select 5.5.1 for Version and CentOS for OS, and click the Download button.

3. On the Downloads and Install page, select tar.gz as the Install Method and select the proper CPU Architecture that matches your system. Click Download Now.

   You can also follow the command instructions on the page.

Start EMQX

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

./emqx/bin/emqx start