EMQX Docs

English

简体中文

English

简体中文

Appearance

Contact Us

Install EMQX on Ubuntu ​

This page guides you on installing and starting the EMQX Open Source edition 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 Open Source download site for installation information.

Install with deb ​

  1. Go to the official download page and select the Ubuntu tab, then select Package.
  2. Select the latest version 5.8.3 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 systemctl service.

bash
sudo systemctl start emqx

Uninstall EMQX ​

To uninstall EMQX, run:

bash
sudo apt remove --purge emqx

Install with tar.gz ​

  1. Go to the official download page and select the Ubuntu tab, then select Package.
  2. Select the latest version 5.8.3 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