What Do I Need to Connect My IoT Device to HiveMQ Cloud Starter?

Owned by Daria Samkova
Sept 10, 2024
2 min read

To connect your IoT device to HiveMQ Cloud, ensure you have the following:

  1. HiveMQ Cloud Account and Cluster
    Create an account and set up a cluster by following the steps in the HiveMQ Cloud Quick Start Guide.

  2. Access Credentials
    Generate a pair of access credentials as described in the Quick Start Guide.

  3. Device Compatibility
    Ensure your device supports the following:

    • TLS (Transport Layer Security)

    • Correct hostname, port, and access credentials

  4. CA Certificate
    Download and install the required CA certificate from Let's Encrypt.

How to Verify Device Compatibility:

  • Does your IoT device support TLS?
    Check the IoT device manufacturer's documentation for TLS support.

Verifying Hostname, Port, and Access Credentials:

To ensure you are using the correct hostname, port, and credentials:

  1. Test the connection with a different MQTT client.
    We recommend using the MQTT-CLI command-line tool.

  2. Attempt to connect using your hostname, port, and credentials.

Connect MQTT clients

Subscribe

To connect to your HiveMQ Cloud cluster and subscribe to the topic my/test/topic, type the following command.

You are asked for the password for the user <your_username>, that you entered before.

mqtt sub -h YOUR_CLUSTER_URL -p 8883 -s -u YOUR_USERNAME -pw -t 'my/test/topic'

This is your first connected MQTT client, that is subscribed and waiting for incoming messages.

Publish

To create another client and send messages to your cluster, open a second terminal window and enter the following command: (keep your original terminal window open)

mqtt pub -h YOUR_CLUSTER_URL -p 8883 -s -u YOUR_USERNAME -pw -t 'my/test/topic' -m 'Hello'

The message Hello appears immediately in the terminal window of the second MQTT client.

To publish another message, just run the mqtt pub ... command again.