Skip to content

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:

    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

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.

Start EMQX

EMQX offers 3 different options to start EMQX:

  • To start EMQX directly, run:

    bash
    $ emqx start
    EMQX 5.6.0 is started successfully!
    
    $ emqx ctl status
    Node 'emqx@127.0.0.1' 5.6.0 is started
  • To start EMQX with systemctl, run:

    bash
    sudo systemctl start emqx
  • To start EMQX as a service, run:

    bash
    sudo service emqx start

Uninstall EMQX

To uninstall EMQX, run:

bash
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.

bash
./emqx/bin/emqx start