EMQX Edge

English

简体中文

English

简体中文

Appearance

Contact Us
Contact Us

Install EMQX Edge on Linux ​

This page guides you through the installation of EMQX Edge on a Linux system. You can install EMQX Edge using one of the following methods:

  • Install via Script: The quickest way to get started. A single curl command downloads and installs the latest EMQX Edge release automatically.
  • Install via Package: Download and extract the package manually for full control over the version and placement.

Install via Script ​

The install script automatically detects your system architecture, downloads the latest EMQX Edge release, verifies its checksum, and installs it to /opt/emqx-edge.

Run the following command:

bash
curl -fsSL emqx.sh/edge | bash

Once the installation is complete, start EMQX Edge:

bash
source /etc/profile.d/emqx-edge.sh && nanomq start

Note: This script only works on Linux. It requires curl, unzip, grep, and awk to be installed, and needs sudo access to write to /opt/emqx-edge and /etc/profile.d/.

Install a Specific Version ​

To install a specific version, set the EMQX_VERSION environment variable:

bash
curl -fsSL emqx.sh/edge | EMQX_VERSION=v1.3.0 bash

Customize the Installation Directory ​

To change the installation directory, set the INSTALL_DIR environment variable:

bash
curl -fsSL emqx.sh/edge | INSTALL_DIR=/custom/path bash

Install via Package ​

Visit the EMQX Edge download page to obtain the appropriate Linux package for your system architecture.

Installation Example (arm64)

The following steps demonstrate how to install EMQX Edge version v1.0.0 on an arm64 device:

  1. Extract the package:

    bash
    unzip ./emqx-edge-1.0.0-linux-arm64.zip

  2. Navigate to the extracted directory, and start EMQX Edge:

    bash
    ./nanomq start

Access the EMQX Edge Dashboard ​

EMQX Edge includes a built-in web-based Dashboard that allows you to monitor system status, manage configurations, and configure required features.

  1. Open a web browser and visit http://localhost:8081 (localhost can be substituted with your IP address).
  2. Log in to the EMQX Edge Dashboard with default credentials:
    • Username: admin
    • Password: public

dashboard_monitor