Install EMQX Enterprise on Debian

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

Supported versions:

• Debian 12
• Debian 11
• Debian 10

The section below will take Debian 11 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

1. Go to EMQ Official Site.
2. Select 5.4.1 for Version and Debian for OS, and click the Download button.
3. On the Downloads and Install page, select deb as the Install Method and select the proper CPU Architecture that matches your system. Download and install the package according to the instruction.

Start EMQX

EMQX offers 3 different options to start EMQX:

• To start EMQX directly, run:

  $ emqx start
  EMQX 5.4.1 is started successfully!
  
  $ emqx ctl status
  Node 'emqx@127.0.0.1' 5.4.1 is started

• To start EMQX as a systemd service, run:

  sudo systemctl start emqx

• To start EMQX as a service, run:

  sudo service emqx start

Uninstall EMQX

To uninstall EMQX, run:

sudo apt remove --purge emqx

Install with tar.gz

1. Go to EMQ Official Site.
2. Select 5.4.1 for Version and Debian for OS, and click the Download button.
3. On the Downloads and Install page, select tar.gz as Install Method and select the proper CPU Architecture that matches your system. Download and install the package according to the instruction.

Start EMQX

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

./emqx/bin/emqx start