EMQX Packages Repository

This repository hosts Debian and RPM packages for EMQX Enterprise, and provides a macOS installer.

Option 1: Quick Install Script

The installer follows GitHub's latest release and selects its major-version repository. Normal package upgrades stay within that major. It auto-detects Debian/Ubuntu, RPM-based Linux, or macOS (Apple Silicon).

curl -fsSL https://repo.emqx.works/install.sh | bash

The v5 and v6 repositories are available. The v7 repository starts with its first published release. Repository names are emqx-enterprise-v5, emqx-enterprise-v6, and emqx-enterprise-v7. The installed package remains emqx-enterprise. Only Enterprise GA packages from 5.8.0 onward are hosted.

Enable one major repository at a time. Disable an existing major repository before switching. Use EMQX_MAJOR=5 to install from the v5 repository. On macOS, choose an exact version with EMQX_VERSION=v6.3.3.

Option 2: Manual Configuration

Choose a major version, then follow the instructions for your operating system. Enable one major repository at a time.

The v6 repository is available. Package updates stay within v6.

Debian/Ubuntu

Example for Ubuntu 24.04 (noble). Replace the codename for your distribution.

# 1. Install prerequisites apt-get update && apt-get install -y curl gpg # 2. Add the GPG key mkdir -p /etc/apt/keyrings/ curl -fsSL https://repo.emqx.works/gpg.key | gpg --dearmor > /etc/apt/keyrings/emqx-enterprise-keyring.gpg # 3. Add the v6 repository echo 'deb [signed-by=/etc/apt/keyrings/emqx-enterprise-keyring.gpg] https://repo.emqx.works/apt/emqx-enterprise-v6 noble main' > /etc/apt/sources.list.d/emqx-enterprise-v6.list # 4. Install apt-get update apt-get install emqx-enterprise

RHEL/Rocky/Amazon Linux

Create /etc/yum.repos.d/emqx-enterprise-v6.repo with the following content. Replace el/9 with your distribution, such as el/8 or amzn/2023.

[emqx-enterprise-v6] name=EMQX Enterprise v6 baseurl=https://repo.emqx.works/rpm/emqx-enterprise-v6/el/9/$basearch gpgcheck=1 repo_gpgcheck=1 gpgkey=https://repo.emqx.works/gpg.key enabled=1

Then install the package:

sudo dnf install emqx-enterprise