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

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

1. Go to the official site for EMQX.

2. Select 5.6.1 for Version and Ubuntu for OS, and click the Download button.

3. On the Downloads and Install page, select deb 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

Start EMQX as a systemd service.

sudo systemctl start emqx

Uninstall EMQX

To uninstall EMQX, run:

sudo apt remove --purge emqx

Install with tar.gz

1. Go to the official site for EMQX.

2. Select 5.6.1 for Version and Ubuntu 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 foreground