Linux

For Linux users, NanoMQ currently provides four deployment versions, each with distinct functionalities as detailed in the table below:

Function	NanoMQ Basic Version (default)	NanoMQ SQLite Edition	NanoMQ MsQuic Edition	NanoMQ Full Version
MQTT Broker Function	✅	✅	✅	✅
TLS/SSL	✅	✅	✅	✅
SQLite	❌	✅	❌	✅
Rule Engine	❌	❌	✅	✅
MQTT over TCP Bridging	✅	✅	✅	✅
MQTT over TLS Bridging	✅	✅	✅	✅
MQTT over QUIC Bridging	❌	❌	✅	✅
AWS Bridging *	❌	❌	❌	❌
ZMQ Gateway	❌	❌	❌	✅
SOME/IP Gateway	❌	❌	❌	❌
DDS Gateway	❌	❌	❌	❌
Bench Benchmark Tools	❌	❌	✅	✅

[^*]: AWS bridging is currently unavailable with Docker deployment. To use AWS bridging, please build NanoMQ from the source code.

You can select the appropriate installation version of NanoMQ based on your specific business requirements. To do this, simply replace nanomq in the installation command with the corresponding version code:

• For the SQLite Edition of NanoMQ, use nanomq-sqlite
• For the MsQuic Edition of NanoMQ, use nanomq-msquic
• For the Full Version of NanoMQ, use nanomq-full

Install NanoMQ

Install with Apt/Yum Source

OS	Installation Method
Debian-based distributions like Ubuntu	Apt
Red Hat-based distributions like CentOS, Fedora	Yum

Install with Package

Architecture	Debian Package (.deb)	RPM Package (.rpm)
amd64	Yes	No
arm64	Yes	Yes
riscv64	Yes	Yes
mips	Yes	Yes
armhf	Yes	Yes
armel	Yes	Yes
X86_64	No	Yes

Install with Apt source

NanoMQ supports installing with Apt source to provide our users with a convenient and reliable way to manage NanoMQ installation and updates. Here is how to install NanoMQ with Apt source:

1. Download the NanoMQ repository:

   curl -s https://assets.emqx.com/scripts/install-nanomq-deb.sh | sudo bash

2. Install NanoMQ:

   sudo apt-get install nanomq

3. Start NanoMQ:

   nanomq start

Install with Yum source

For Red Hat-based distributions like CentOS, Fedora, NanoMQ also supports installing with Yum source. Here is how to install NanoMQ with Yum source:

1. Download the NanoMQ repository:

   curl -s https://assets.emqx.com/scripts/install-nanomq-rpm.sh | sudo bash

2. Install NanoMQ:

   sudo yum install -y nanomq

3. Start NanoMQ:

   nanomq start

Install with Package

This section takes installing v0.18.2 under the arm64 architecture as an example, for more installation options, you may refer to the NanoMQ Download page.

1. Download anomq-0.18.2-linux-x86_64.rpm.

   wget https://www.emqx.com/en/downloads/nanomq/0.18.2/nanomq-0.18.2-linux-arm64.deb

2. Install NanoMQ

   sudo apt install ./nanomq-0.18.2-linux-arm64.deb

3. Run NanoMQ

   nanomq start

Install with AUR

The AUR (Arch User Repository) is a community-driven repository for Arch Linux users. It contains package descriptions (PKGBUILDs) that allow you to compile a package from the source and then install it via the Arch Linux package manager (pacman). NanoMQ also supports installing with AUR

• Nanomq basic edition

  yay -S nanomq

• Nanomq SQLite edition

  yay -S nanomq-sqlite

• Nanomq MsQuic edition

  yay -S nanomq-msquic

• Nanomq full edition

  yay -S nanomq-full

Installation package folders

The binary installation package contents are:

Folders	functional
/etc	All configuration files of NanoMQ
/usr/local/bin	NanoMQ' binary files
/usr/local/lib	internal dynamic/static libs of NanoMQ