# CentOS/RHEL

This section will guide you on how to install and start EMQX on CentOS/RHEL system.

Supported versions:

  • CentOS 7
  • CentOS 8

# Install EMQX with rpm

  1. To download emqx-5.0.14-el8-amd64.rpm (opens new window), run:
wget https://www.emqx.com/downloads/broker/v5.0.14/emqx-5.0.14-el8-amd64.rpm
1
  1. To install EMQX, run:
sudo yum install ./emqx-5.0.14-el8-amd64.rpm -y
1
  1. To run EMQX, run:
  • To start EMQX directly, run:

    $ emqx start
    EMQX 5.0.14 is started successfully!
    
    $ emqx_ctl status
    Node 'emqx@127.0.0.1' 5.0.14 is started
    
    1
    2
    3
    4
    5
  • To start EMQX with systemctl, run:

    sudo systemctl start emqx
    
    1
  • To start EMQX as a service, run:

    sudo service emqx start
    
    1
  1. To uninstall EMQX, run:
sudo yum remove emqx
1

# Install EMQX with tag.gz

  1. To download emqx-5.0.14-el8-amd64.tar.gz (opens new window), run:
wget https://www.emqx.com/downloads/broker/v5.0.14/emqx-5.0.14-el8-amd64.tar.gz
1
  1. To unzip the package, run:
mkdir -p emqx && tar -zxvf emqx-5.0.14-el8-amd64.tar.gz -C emqx
1
  1. To start EMQX, run:
cd emqx && ./bin/emqx start
1