Go to file
JimMoen ef28579c4a
Merge pull request #13334 from JimMoen/fix-mqtt-username-password-flag
fix(mqtt): check password flag to respect protocol spec
2024-06-27 16:16:53 +08:00
.ci Merge pull request #13274 from kjellwinblad/kjell/add_ssl_to_rocksdb/EMQX-12289 2024-06-18 09:38:28 +02:00
.github ci: add debugging info when building for docker tests 2024-06-26 13:41:07 -03:00
apps Merge pull request #13334 from JimMoen/fix-mqtt-username-password-flag 2024-06-27 16:16:53 +08:00
bin fix(bin/emqx): ensure -noinput is prior to -noshell 2024-06-05 21:55:39 +02:00
changes Merge pull request #13334 from JimMoen/fix-mqtt-username-password-flag 2024-06-27 16:16:53 +08:00
deploy build: pin base docker image to stable-20240612-slim 2024-06-26 15:49:10 +02:00
rel Merge pull request #13324 from lafirest/feat/oidc-572 2024-06-27 11:24:05 +08:00
scripts fix(oidc): make CI happy 2024-06-24 18:11:02 +08:00
.editorconfig chore(readme): remove legacy Travis mentions 2023-01-02 21:49:32 +03:00
.formatter.exs style(format): format elixir files 2021-12-27 10:51:12 -03:00
.gitattributes chore: add a pre-commit hook to auto format erlang code 2022-04-27 08:01:55 +02:00
.gitignore chore: make it easier to override default profile 2024-05-23 17:30:06 +02:00
.tool-versions chore: bump OTP to 26.2.5-2 2024-06-10 13:41:23 -03:00
APL.txt refactor(sqlserver): move sqlserver bridge into its own app 2023-05-06 10:22:05 +08:00
CONTRIBUTING.md docs: align notation for change log file name pattern 2023-07-06 15:33:33 +02:00
Dockerfile.ubuntu20.04.runner ci: pin dockerfiles by digest 2024-01-12 11:55:51 +01:00
Dockerfile.ubuntu20.04.runner.dockerignore test: Dockerfile:s to build test images 2022-06-12 20:18:48 +02:00
LICENSE docs(license): change license contents after review 2023-04-24 10:28:26 -03:00
Makefile build: pin base docker image to stable-20240612-slim 2024-06-26 15:49:10 +02:00
NOTICE chore: update copyright-year 2024-02-23 08:21:06 +01:00
PLUGIN.md docs: More EMQ X -> EMQX rename in descriptive strings 2022-02-15 22:39:11 +01:00
README-CN.md feat: make the dashboard restart quicker 2024-06-14 18:22:34 +08:00
README-RU.md feat: make the dashboard restart quicker 2024-06-14 18:22:34 +08:00
README.md feat: make the dashboard restart quicker 2024-06-14 18:22:34 +08:00
SECURITY.md docs: add security policy 2023-07-12 10:45:53 +02:00
build chore: bump OTP to 26.2.5-2 2024-06-10 13:41:23 -03:00
dev chore: handle ctl command return 'true' 2024-05-27 20:59:50 +02:00
elvis.config chore: remove lib-ee in scripts 2023-10-11 20:12:57 +02:00
git-blame-ignore-revs chore: bump git-blame-ignore-revs 2023-12-29 09:08:21 +08:00
mix.exs fix(oidc): make CI happy 2024-06-24 18:11:02 +08:00
pkg-vsn.sh chore: enforce chart version matching release version in emqx_release.hrl 2023-08-11 09:15:27 +02:00
rebar.config chore: upgrade ekka to 0.19.5 (mria 0.8.8) 2024-06-20 12:53:58 +03:00
rebar.config.erl Merge pull request #13211 from qzhuyan/fix/william/rel57/ee-tls 2024-06-13 13:19:44 +02:00

README.md

English | 简体中文 | Русский

EMQX

GitHub Release Build Status Coverage Status Docker Pulls OpenSSF Scorecard Slack Discord Twitter YouTube

EMQX is the world's most scalable open-source MQTT broker with a high performance that connects 100M+ IoT devices in 1 cluster, while maintaining 1M message per second throughput and sub-millisecond latency.

EMQX supports multiple open standard protocols like MQTT, HTTP, QUIC, and WebSocket. Its 100% compliant with MQTT 5.0 and 3.x standard, and secures bi-directional communication with MQTT over TLS/SSL and various authentication mechanisms.

With the built-in powerful SQL-based rules engine, EMQX can extract, filter, enrich and transform IoT data in real-time. In addition, it ensures high availability and horizontal scalability with a masterless distributed architecture, and provides ops-friendly user experience and great observability.

EMQX boasts more than 20K+ enterprise users across 50+ countries and regions, connecting 100M+ IoT devices worldwide, and is trusted by over 400 customers in mission-critical scenarios of IoT, IIoT, connected vehicles, and more, including over 70 Fortune 500 companies like HPE, VMware, Verifone, SAIC Volkswagen, and Ericsson.

For more information, please visit EMQX homepage.

Get Started

Run EMQX in the Cloud

The simplest way to set up EMQX is to create a managed deployment with EMQX Cloud. You can try EMQX Cloud for free, no credit card required.

Run EMQX using Docker

docker run -d --name emqx -p 1883:1883 -p 8083:8083 -p 8084:8084 -p 8883:8883 -p 18083:18083 emqx/emqx:latest

Next, please follow the Deploy with Docker guide for further instructions.

Run EMQX cluster on Kubernetes

Please consult official EMQX Operator documentation for details.

Run EMQX on macOS

EMQX is available as core Homebrew package.

brew install emqx
emqx start

More installation options

If you prefer to install and manage EMQX yourself, you can download the latest version from www.emqx.io/downloads.

For more installation options, see the EMQX installation documentation.

Documentation

The EMQX documentation is available at www.emqx.io/docs/en/latest/.

The EMQX Enterprise documentation is available at docs.emqx.com/en/.

Contributing

Please see our contributing.md.

For more organised improvement proposals, you can send pull requests to EIP.

Get Involved

Resources

  • MQTT client programming

    A series of blogs to help developers get started quickly with MQTT in PHP, Node.js, Python, Golang, and other programming languages.

  • MQTT SDKs

    We have selected popular MQTT client SDKs in various programming languages and provided code examples to help you quickly understand the use of MQTT clients.

  • MQTTX

    An elegant cross-platform MQTT 5.0 client tool that provides desktop, command line, and web to help you develop and debug MQTT services and applications faster.

  • Internet of Vehicles

    Build a reliable, efficient, and industry-specific IoV platform based on EMQ's practical experience, from theoretical knowledge such as protocol selection to practical operations like platform architecture design.

Build From Source

The master branch tracks the latest version 5. For version 4.4 checkout the main-v4.4 branch.

EMQX 4.4 requires OTP 24. EMQX 5.0 ~ 5.3 can be built with OTP 24 or 25. EMQX 5.4 and newer can be built with OTP 25 or 26.

git clone https://github.com/emqx/emqx.git
cd emqx
make
_build/emqx/rel/emqx/bin/emqx console

For 4.2 or earlier versions, release has to be built from another repo.

git clone https://github.com/emqx/emqx-rel.git
cd emqx-rel
make
_build/emqx/rel/emqx/bin/emqx console

License

See LICENSE.