Connect a Client

3min

You can connect to Litmus UNS through an MQTT client such as MQTT Explorer.

Before You Begin

You will need to Add a User and use the username and password to connect to Litmus UNS.

Step 1: Access Connection Parameters

To access connection parameters for the different types of MQTT connections, navigate to the Litmus UNS dashboard and click Connect.

Connect button
Connect button


From the Connect to IDE dialog, review the hostnames and port numbers required for each type of MQTT connection. You can also download the certificate for Litmus UNS.

Connection parameters for MQTT connections
Connection parameters for MQTT connections


Step 2: Connect to Client

Once you have defined the type of connection you want to create, you can connect to Litmus UNS through a client such as MQTT Explorer. For these steps, we will use the MQTT Explorer client and create an MQTT connection.

To connect to a client:

  1. Open MQTT Explorer. The MQTT Connection dialog displays.
  2. Enter a name for the connection.
  3. For Protocol, select mqtt://.
  4. For Host, enter the hostname from Step 1: Access Connection Parameters.
  5. For Port, enter 1883. This is the port number to configure an MQTT connection. Note: For private beta, the port number is set to 1883. When Litmus UNS is released for general availability, you will be able to customize the port.
  6. Enter the appropriate Username and Password for the account you want to use to connect. See Add a User to learn more.
  7. Click Advanced.
  8. For MQTT Client ID, enter or paste the Client ID for the user. See Add a User to learn more.
  9. Click Back.
  10. Click Connect. The client should successfully connect.