Using EMQX 5.8.9 as the baseline, walk me through the whole path from adding the WoowTech repository to starting add-on 5.9.0; explain host_network, the five ports, and changing the password on first login. Answer in English.
WoowTech · EMQX 5.8.9 Prompt Library
50 EMQX prompts you can search and copy
Swap the bracketed placeholders for details from your own environment. By default the prompts verify first, preview next and change last; anything that deletes, restores or exposes something still needs your approval, and never paste secrets into a third-party model. Every prompt ends with "Answer in English." Remove that sentence if you want another language.
Press a card's Copy button to copy the whole prompt.
Install and start
I want to install [Woow EMQX add-on] on my [Home Assistant version]. First check whether the existing Mosquitto is holding [1883], then give me an install order that avoids a port conflict. Answer in English.
What is the difference between EMQX add-on 5.9.0 and EMQX 5.8.9? In one paragraph, explain why the add-on version and the EMQX version must not be used interchangeably, and say exactly where the ngrok TCP tunnel fits. Answer in English.
The Dashboard will not open after I installed [Woow EMQX add-on]. Work through four symptoms: will not start, cannot connect, Dashboard will not open, and port conflict. Confirm [host URL] and [account] first, then give me a read-only checking order. Answer in English.
Build a pre-install checklist for EMQX 5.8.9 on [emqx-guide.woowtech.io], covering [host_network], [monitoring], and up-front planning for backups and certificates; give advice only, do not create any data. Answer in English.
Connecting and diagnostics
I cannot connect to EMQX with [MQTT client]. List the possible causes across four layers: Listener, Authentication, ACL and network, with one way to verify each layer. Use read-only checks, and do not kick out any client. Answer in English.
Build me a verifiable MQTT connection diagnostic procedure: confirm [EMQX address 1883] first, then publish/subscribe with the built-in WebSocket client, recording [QoS] and any error messages. Answer in English.
My client keeps dropping and reconnecting. Explain how EMQX keepalive, session and the will message affect disconnects, and suggest a workable [keepalive] and [will topic]. Answer in English.
I connected with [MQTT tool] and see no messages. Check whether I subscribed to the wrong topic, whether an ACL is blocking it, and whether the subscription is [QoS 0]; give a way to verify each one. Answer in English.
Design a way to confirm a client is really online in EMQX: read Clients, Subscriptions, the birth/will topics and node monitoring, and say which of those are live and which are stale. Answer in English.
Authentication
Give me the minimum safe setup for Password-Based (built-in database) authentication: create users, disable the accounts you do not need, and change the default password; write every password as [placeholder] and never output a real value. Answer in English.
Compare the EMQX 5.8.9 authentication backends: Password-Based, JWT, HTTP and LDAP. Write it as a comparison table showing which ones you can configure directly in the Dashboard UI. Answer in English.
I want to authenticate connections with JWT. Using the official EMQX v5.8 docs as the source of truth, explain how the JWT payload and the signing [secret] have to match; if 5.8.9 does not expose it in the UI by default, write it up as advanced configuration. Answer in English.
I am wiring up an [HTTP Authentication backend]. Write the example with placeholders: the HTTP status the endpoint returns and how a deny is decided, then explain how to test that an unauthorized client really is blocked. Answer in English.
Write an authentication-ready checklist for the first login to EMQX: change the default password, create a test user, and confirm that rejected clients show up in the log; use [your_password] as the placeholder for every password. Answer in English.
Authorization and ACL
Show me how to build least privilege with the EMQX Built-in Database ACL: let only a specific client subscribe to [home/+/status] and deny every other topic; start with the rule matching order and the deny policy. Answer in English.
My client [ex-client] needs to publish. Explain the ACL authorization order, the built-in rules and how deny-takes-precedence relates to them, then give a least-privilege example. Answer in English.
Build a comparison of the EMQX ACL against the HA Mosquitto configuration: authorization order, MQTT topic filters and wildcards, and which Metrics or logs to watch while testing. Answer in English.
I only want to allow the clients that drive the living-room lights to control them. Design a least-privilege list with EMQX ACL topic rules, and explain why it has to be paired with authentication. Answer in English.
Authorization test: a user may subscribe only to the MQTT topic filter home/#. Tell me how to verify in EMQX that they cannot publish to any other topic, without actually kicking that client out. Answer in English.
Listeners and TLS
Help me understand the EMQX default ports: 1883 (MQTT), 8083 (WS), 8084 (WSS), 8883 (MQTTS). Explain what each one is for, one at a time, and warn me about port conflicts. Answer in English.
I want to run multiple Listeners on each of several network segments. Walk me through the EMQX 5.8.9 add/edit Listener flow with placeholder IPs; change nothing that is already configured. Answer in English.
I need to set up TLS on [8883]. Explain how to point at the certificate with [placeholder certificate path], the TLS/mTLS concepts in EMQX 5.8.9, and how to keep certificate private keys out of the document. Answer in English.
I hit a port conflict on [1883]. Explain which of EMQX, HA Mosquitto or another service might be holding it and which side to change; write it up as one procedure, and change no settings. Answer in English.
I want to test a WSS connection. Give me the route to the 8084 endpoint, and remind me to put only a test user and placeholder certificates in it; certificate private keys never go into teaching material. Answer in English.
Rule Engine
Teach me to write my first EMQX SQL rule: use [topic] as the source, filter with SELECT/FROM/WHERE, and watch the hits in Console Output before letting it through. Answer in English.
Compare the EMQX built-in actions: Console Output, Republish and Topic Rewrite. Give one situation where each fits, and explain the order: test first, then go live. Answer in English.
Write a rule that pulls the payload of [temperature sensor topic] apart into fields. Use the EMQX 5.x Data Integration (Rules/Actions) vocabulary; do not mix in the 4.x Data Bridge wording. Answer in English.
I need a rule that republishes [topic A] to [topic B]. Show the SQL and the action, and warn me that a loop is possible if both ends subscribe to the same place. Answer in English.
Build a smart home scenario with an EMQX rule: when [living-room sensor] goes above [28 C], republish to the [alert] topic. Give the SQL first, then the console test and the risks to watch. Answer in English.
Connectors, sinks and sources
Explain Data Integration in EMQX 5.8.9: how Connector, Sink, Source and Rule chain together. Use a Webhook as the example, sending messages out to the placeholder [HTTP URL]. Answer in English.
I want to send EMQX messages to a [REST API]. Use a Webhook/HTTP Connector example, insist on placeholders ([api_base_url], [your_api_key]), and keep secrets out of the document. Answer in English.
The Kafka, PostgreSQL and MySQL Sink concepts: for each, give one design direction for when I want to store messages, and mark which ones are harder to configure directly in the v5.8.9 UI. Answer in English.
I want to write data from an external service back into EMQX. Compare what to watch out for with a Source versus a bridge across brokers. Answer in English.
How many times should a Sink retry a failed HTTP call? Start with what the EMQX docs say about Timeout and error logging, then give a fault-tolerant approach and a [retry value] placeholder. Answer in English.
Home Assistant integration
I am moving Home Assistant from the built-in Mosquitto to EMQX. List the migration steps: back up, stop the old broker, repoint the HA MQTT integration, and verify discovery/birth/will. Do not pretend this is guaranteed zero downtime. Answer in English.
I have only one EMQX and want to share it with Zigbee2MQTT. Explain the authentication and ACL that EMQX has to satisfy first when the broker is shared, otherwise Z2M discovery is rejected. Answer in English.
Once EMQX is connected to Home Assistant, what should I confirm about birth/will, the status topics and whether discovery reaches the Dashboard? Write it up as an acceptance checklist. Answer in English.
Before I bring [all HA entities] across, write a list of which topics are involved and which connection tests are needed; use a placeholder for every username and password. Answer in English.
Home Assistant will not open the EMQX Web UI. Explain how the Open Web UI Ingress route works, and which setting could be blocking [Dashboard URL]. Answer in English.
Monitoring and operations
Set a monitoring baseline for EMQX: Overview, node resources, client count and message rate. Output the host and the [threshold values], and run nothing that changes state. Answer in English.
Review [EMQX logs] over [time range], group the repeated messages, and mark the first root-cause candidate and the errors that cascaded from it; you may redact anything sensitive. Answer in English.
Teach me how to read Clients/Subscriptions in the EMQX Dashboard. List only read-only ways to confirm who is online and what they subscribed to, and do not kick anyone out. Answer in English.
Design a troubleshooting runbook for EMQX dropping connections in the middle of the night: start with Node Metrics, system resources, Rate and Log, then check [WAN], and keep reset as the last step. Answer in English.
Write a conceptual explanation of EMQX with Prometheus: Dashboard statistics, node status, system resources and rate metrics are the data sources; point out which of them you can read directly in v5.8.9. Answer in English.
Backup, restore and security
Write out the backup scope for EMQX 5.8.9: /data/emqx (data, ACL, authentication, rules), the config files, and how to handle the ngrok authtoken; look up the official sources for any path you are unsure about. Answer in English.
Design a restore drill for EMQX: verify the backup is readable, restore in isolation, compare authentication/ACL, and reconnect the clients; never restore into production. Answer in English.
Review the attack surface of [EMQX deployment]: keeping the admin surface off the public internet, host_network risk, Rate Limit, TLS, least privilege and secret management; list the fixes by severity. Answer in English.
I want to put the ngrok authtoken in an environment variable. Write it up with a placeholder (your_ngrok_authtoken), stress that the token never goes into the document, and compare Cloudflare Tunnel as an alternative. Answer in English.
Write up what to watch for when you back up, restore, update and migrate EMQX. Structure it as back up first, then update, then re-verify, and add one line about when to go back to the official docs. Answer in English.