Skip to content

Install EMQX on Ubuntu

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

Supported versions:

  • Ubuntu 24.04
  • 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:

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

    bash
    sudo apt-get install emqx
  3. Start EMQX:

    bash
    sudo systemctl start emqx

Install with Package

EMQX supports installation via deb packages or tar.gz packages. For installation on other supported systems or to try other versions, please visit the EMQX Enterprise download site for installation information.

Install with deb

  1. Go to the official download page and select the Ubuntu tab.
  2. Select the latest version 5.7.1 and select the deb package according to the required version and CPU architecture in the Package Type dropdown.
  3. Click the link below for downloading. You can also follow the command-line guide steps for downloading and installing.

Start EMQX

Start EMQX as a systemd service.

bash
sudo systemctl start emqx

Uninstall EMQX

To uninstall EMQX, run:

sudo apt remove --purge emqx

Install with tar.gz

  1. Go to the official download page and select the Ubuntu tab.
  2. Select the latest version 5.7.1 and select the tar.gz package according to the required version and CPU architecture in the Package Type dropdown.
  3. Click the link below for downloading. You can also follow the command-line guide steps for downloading and installing.

Start EMQX

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

bash
./emqx/bin/emqx foreground