This repository hosts Debian and RPM packages for EMQX Enterprise, and provides a macOS installer.
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.
Choose a major version, then follow the instructions for your operating system. Enable one major repository at a time.
The v5 repository is available. Package updates stay within v5.
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 v5 repository
echo 'deb [signed-by=/etc/apt/keyrings/emqx-enterprise-keyring.gpg] https://repo.emqx.works/apt/emqx-enterprise-v5 noble main' > /etc/apt/sources.list.d/emqx-enterprise-v5.list
# 4. Install
apt-get update
apt-get install emqx-enterprise
Create /etc/yum.repos.d/emqx-enterprise-v5.repo with the following content.
Replace el/9 with your distribution, such as el/8 or amzn/2023.
[emqx-enterprise-v5]
name=EMQX Enterprise v5
baseurl=https://repo.emqx.works/rpm/emqx-enterprise-v5/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
The v6 repository is available. Package updates stay within v6.
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
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
The v7 repository starts with its first published GA release.
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 v7 repository
echo 'deb [signed-by=/etc/apt/keyrings/emqx-enterprise-keyring.gpg] https://repo.emqx.works/apt/emqx-enterprise-v7 noble main' > /etc/apt/sources.list.d/emqx-enterprise-v7.list
# 4. Install
apt-get update
apt-get install emqx-enterprise
Create /etc/yum.repos.d/emqx-enterprise-v7.repo with the following content.
Replace el/9 with your distribution, such as el/8 or amzn/2023.
[emqx-enterprise-v7]
name=EMQX Enterprise v7
baseurl=https://repo.emqx.works/rpm/emqx-enterprise-v7/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