# 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:

Download the EMQX repository:

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

Install EMQX:
```
sudo yum install emqx -y
```
1
Start EMQX:
```
sudo systemctl start emqx
```
1

# 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 (opens new window).

# Install with rpm

EMQX offers different installation packages for different CPU architectures.

# 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

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

# Uninstall EMQX

To uninstall EMQX, run:

sudo apt remove --purge emqx

# Install with tar.gz

EMQX offers different installation packages for different CPU architectures.

# Start EMQX

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

./emqx/bin/emqx start

← Ubuntu Amazon Linux 2 →