Debian

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

Supported versions:

• Debian 12
• Debian 11
• Debian 10

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

2. Install EMQX:

   sudo apt-get install emqx

3. Start EMQX:

   sudo systemctl start emqx

Install with Package

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

EMQX offers different installation packages for different CPU architectures.

• amd64
• arm64

1. Download emqx-5.1.6-debian11-amd64.deb.

   wget https://www.emqx.com/en/downloads/broker/5.1.6/emqx-5.1.6-debian11-amd64.deb

2. Install EMQX.

   sudo apt install ./emqx-5.1.6-debian11-amd64.deb

1. Download emqx-5.1.6-debian11-arm64.deb.

   wget https://www.emqx.com/en/downloads/broker/5.1.6/emqx-5.1.6-debian11-arm64.deb

2. Install EMQX.

   sudo apt install ./emqx-5.1.6-debian11-arm64.deb

Start EMQX

EMQX offers 3 different options to start EMQX:

• To start EMQX directly, run:

  $ emqx start
  EMQX 5.1.6 is started successfully!
  
  $ emqx ctl status
  Node 'emqx@127.0.0.1' 5.1.6 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

EMQX offers different installation packages for different CPU architectures.

• amd64
• arm64

1. Download emqx-5.1.6-debian11-amd64.tar.gz.

   wget https://www.emqx.com/en/downloads/broker/5.1.6/emqx-5.1.6-debian11-amd64.tar.gz

2. Install EMQX.

   mkdir -p emqx && tar -zxvf emqx-5.1.6-debian11-amd64.tar.gz -C emqx

1. Download emqx-5.1.6-debian11-arm64.tar.gz.

   wget https://www.emqx.com/en/downloads/broker/5.1.6/emqx-5.1.6-debian11-arm64.tar.gz

2. Install EMQX.

   mkdir -p emqx && tar -zxvf emqx-5.1.6-debian11-arm64.tar.gz -C emqx

Start EMQX

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

./emqx/bin/emqx start