# macOS

This section guides you on installing and starting EMQX on macOS with a zip file.

Supported versions:

macOS 12
macOS 11

The section takes macOS 12 as an example to illustrate how to download the latest version of EMQX. If you want to install a different version or in a different system, please visit the EMQX Deployment page (opens new window)

# Install EMQX

Download emqx-5.0.26-macos12-arm64.zip (opens new window).

wget https://www.emqx.com/en/downloads/broker/5.0.26/emqx-5.0.26-macos11-amd64.zip

Install EMQX.

mkdir -p emqx && unzip emqx-5.0.26-macos11-amd64.zip -d emqx

# Start EMQX

EMQX offers 3 different options to start EMQX:

To start EMQX directly, run:

$ emqx start
EMQX 5.0.26 is started successfully!

$ emqx_ctl status
Node 'emqx@127.0.0.1' 5.0.26 is started

1
2
3
4
5

To start EMQX with systemctl, run:
```
sudo systemctl start emqx
```
1
To start EMQX as a service, run:
```
sudo service emqx start
```
1

# Uninstall EMQX

To uninstall EMQX, run:

sudo apt remove --purge emqx

← Amazon Linux 2 EMQX on Kubernetes (opens new window) →