Support

Requirements

• iPhone or iPad running iOS 15 or later
• An MQTT broker reachable from your device — local network, VPN or 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 will tell you whether the issue is 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 certificate and private key in the Certificate Wizard, set the ALPN protocol to x-amzn-mqtt-ca (or use port 8883), and the app will handle SNI automatically.

Importing a certificate isn't working — what should I check?

Make sure the file is .p12/.pfx or PEM, that the private key matches the certificate, and that any passphrase is entered. The Certificate Wizard flags expiry, SAN/CN mismatches and incomplete chains 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.