![]() |
||
---|---|---|
.. | ||
README.md | ||
alarm.conf.example | ||
cluster-with-dns.conf.example | ||
cluster-with-etcd-ssl.conf.example | ||
cluster-with-etcd.conf.example | ||
cluster-with-k8s.conf.example | ||
cluster-with-manual.conf.example | ||
cluster-with-static.conf.example | ||
conn_congestion.conf.example | ||
dashboard-with-http.conf.example | ||
dashboard-with-https.conf.example | ||
delayed.conf.example | ||
exhook.conf.example | ||
flapping_detect.conf.example | ||
force_gc.conf.example | ||
force_shutdown.conf.example | ||
gateway.coap.conf.example | ||
gateway.exproto.conf.example | ||
gateway.lwm2m.conf.example | ||
gateway.mqttsn.conf.example | ||
gateway.stomp.conf.example | ||
listeners.quic.conf.example | ||
listeners.ssl.conf.example | ||
listeners.tcp.conf.example | ||
listeners.ws.conf.example | ||
listeners.wss.conf.example | ||
log.console.conf.example | ||
log.file.conf.example | ||
mqtt.conf.example | ||
node.conf.example | ||
plugins.conf.example | ||
prometheus-pushgateway.conf.example | ||
prometheus.conf.example | ||
psk_authentication.conf.example | ||
rate_limit.conf.example | ||
retainer.conf.example | ||
sys_topics.conf.example | ||
sysmon.os.conf.example | ||
sysmon.vm.conf.example |
README.md
Examples
Here are examples of how to configure EMQX. The main purpose of the examples are to serve as a reference for configuration layout and syntax, but not a guide to how to configure EMQX. For more information about EMQX configuration, please refer to EMQX documentation (links below).
There are two ways to extend the configuration of EMQX:
- By adding the configs to
emqx.conf
file. - By adding the configs to a new file and include it in
emqx.conf
file. For example, addinclude "mylisteners.conf"
toemqx.conf
file and add the listeners tomylisteners.conf
.
EMQX configuration consists of two parts: static configs and dynamic configs.
- Configs loaded from
emqx.conf
(and included files) are static configs. - Configs added or updated from the dashboard or CLI are dynamic configs which are synced to all nodes in the cluster and stored in the data directory on each node.
It is important to note that static configs are loaded when EMQX starts and overlays on top of the dynamic configs, to avoid confusion, it is highly recommended NOT to use the same config name for both static and dynamic configs.
Documentation
The EMQX documentation is available at www.emqx.io/docs/en/latest/.
The EMQX Enterprise documentation is available at docs.emqx.com/en/.