# Linux

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

FunctionNanoMQ Basic Version (default)NanoMQ SQLite EditionNanoMQ MsQuic EditionNanoMQ 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

OSInstallation Method
Debian-based distributions like UbuntuApt
Red Hat-based distributions like CentOS, FedoraYum

Install with Package

ArchitectureDebian Package (.deb)RPM Package (.rpm)
amd64YesNo
arm64YesYes
riscv64YesYes
mipsYesYes
armhfYesYes
armelYesYes
X86_64NoYes

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

    sudo apt-get install nanomq
    
    1
  3. Start NanoMQ:

    nanomq start  
    
    1

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

    sudo yum install -y nanomq
    
    1
  3. Start NanoMQ:

    nanomq start  
    
    1

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

  1. Download anomq-0.18.2-linux-x86_64.rpm (opens new window).

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

    sudo apt install ./nanomq-0.18.2-linux-arm64.deb
    
    1
  3. Run NanoMQ

    nanomq start
    
    1

# 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
    
    1
  • Nanomq SQLite edition

    yay -S nanomq-sqlite
    
    1
  • Nanomq MsQuic edition

    yay -S nanomq-msquic
    
    1
  • Nanomq full edition

    yay -S nanomq-full
    
    1

# Installation package folders

二进制安装包内容有:

Foldersfunctional
/etcAll configuration files of NanoMQ
/usr/local/binNanoMQ' binary files
/usr/local/libinternal dynamic/static libs of NanoMQ