Install EMQX on Ubuntu

This page guides you on installing and starting EMQX on the Ubuntu system.

Supported versions:

• Ubuntu 22.04
• Ubuntu 20.04
• Ubuntu 18.04

Install with Apt Source

EMQX supports installing with Apt source to provide our users with a convenient and reliable way to manage EMQX installation and updates. Here is how to install EMQX with Apt source:

1. Download the EMQX repository:

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

2. Install EMQX:

   sudo apt-get install emqx

3. Start EMQX:

   sudo systemctl start emqx

Install with Package

The section below will take Ubuntu 22.04 as an example to illustrate how to download the latest version of EMQX. For other versions, please visit the EMQX Deployment page.

Install with deb

EMQX offers different installation packages for different CPU architectures.

1. Download emqx-5.6.1-ubuntu22.04-amd64.deb.

   wget https://www.emqx.com/en/downloads/broker/5.6.1/emqx-5.6.1-ubuntu22.04-amd64.deb

2. Install EMQX.

   sudo apt install ./emqx-5.6.1-ubuntu22.04-amd64.deb

1. Download emqx-5.6.1-ubuntu22.04-arm64.deb.

   wget https://www.emqx.com/en/downloads/broker/5.6.1/emqx-5.6.1-ubuntu22.04-arm64.deb

2. Install EMQX.

   sudo apt install ./emqx-5.6.1-ubuntu22.04-arm64.deb

Start EMQX

Start EMQX as a systemctl service.

sudo systemctl start emqx

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.6.1-ubuntu22.04-amd64.tar.gz.

   wget https://www.emqx.com/en/downloads/broker/5.6.1/emqx-5.6.1-ubuntu22.04-amd64.tar.gz

2. Install EMQX.

   mkdir -p emqx && tar -zxvf emqx-5.6.1-ubuntu22.04-amd64.tar.gz -C emqx

1. Download emqx-5.6.1-ubuntu22.04-arm64.tar.gz。

   wget https://www.emqx.com/en/downloads/broker/5.6.1/emqx-5.6.1-ubuntu22.04-arm64.tar.gz

2. Install EMQX.

   mkdir -p emqx && tar -zxvf emqx-5.6.1-ubuntu22.04-arm64.tar.gz -C emqx

Start EMQX

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

./emqx/bin/emqx foreground