# 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
    
    1
  2. Install EMQX:

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

    sudo systemctl start emqx
    
    1

# 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 (opens new window).

# 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:

    $ emqx start
    EMQX 5.2.1 is started successfully!
    
    $ emqx ctl status
    Node 'emqx@127.0.0.1' 5.2.1 is started
    
    1
    2
    3
    4
    5
  • To start EMQX with systemctl, run:

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

    sudo service emqx start
    
    1

# Uninstall EMQX

To uninstall EMQX, run:

sudo apt remove --purge emqx
1

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

./emqx/bin/emqx start
1