Support

Requirements

• iPhone or iPad running iOS 17 or later
• An MQTT broker reachable from your device over the local network, a VPN or the internet
• For TLS, the broker's CA; for mTLS, a client certificate and key

Common questions

How do I connect to a local Mosquitto broker?

Add a profile with your broker's host (or IP) and port: 1883 for plain MQTT, 8883 for TLS. If it won't connect, open Connection Doctor. It names the failing layer: DNS, TCP, TLS or MQTT.

How do I connect to Home Assistant?

Use the Home Assistant template, point it at your broker (often the Mosquitto add-on on port 1883 or 8883), and subscribe to homeassistant/# to see discovery topics. Enter the MQTT username and password you configured in Home Assistant.

How do I work with Zigbee2MQTT?

Subscribe to zigbee2mqtt/# to see your devices. The app includes safe command templates for actions like permit_join and restart so you don't have to hand-craft the JSON.

How do I connect to AWS IoT Core?

AWS IoT requires mutual TLS. Import your device identity as a .p12/.pfx bundle in the Certificate Manager, set the ALPN protocol to x-amzn-mqtt-ca (or use port 8883), and the app handles SNI for you.

What should I check if a certificate won't import?

Make sure the CA is PEM and your client identity is a .p12/.pfx bundle (a standalone PEM private key isn't supported), and that you've entered any passphrase. The Certificate Manager flags expiry, SAN/CN and hostname mismatches so you can see what's wrong.

Can I delete a retained message?

Yes. Publishing an empty payload with the retain flag clears a retained message. MQTT Commander asks you to confirm first, so you never wipe a topic by accident.

How do I export a session for a bug report?

Use the message log's export to CSV or JSON. Exports redact secrets and raw payloads, so they're safe to share in a ticket or with a colleague.