# Debian

This section will guide you on installing and starting EMQX on the Debian system.

Supported versions:

  • Debian10
  • Debian11

# Install EMQX with deb

  1. To download emqx-5.0.14-debian11-amd64.deb (opens new window), run:
wget https://www.emqx.com/downloads/broker/v5.0.14/emqx-5.0.14-debian11-amd64.deb
1
  1. To install EMQX, run:
sudo apt install ./emqx-5.0.14-debian11-amd64.deb
1
  1. We offered different options to start EMQX:
  • To start EMQX directly, run:

    $ emqx start
    EMQX 5.0.14 is started successfully!
    
    $ emqx_ctl status
    Node 'emqx@127.0.0.1' 5.0.14 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
  1. To uninstall EMQX, run:
sudo apt remove --purge emqx
1

# Install EMQX with tag.gz

  1. To download emqx-5.0.14-debian11-amd64.deb (opens new window), run:
wget https://www.emqx.com/downloads/broker/v5.0.14/emqx-5.0.14-debian11-amd64.tar.gz
1
  1. To unzip the package, run:
mkdir -p emqx && tar -zxvf emqx-5.0.14-debian11-amd64.tar.gz -C emqx
1
  1. To start EMQX, run:
cd emqx && ./bin/emqx start
1