HomeManaged ServicesIoT HubHow to
Connect to the default MQTT network
Update content

How to connect to the default MQTT network

Reviewed on 19 June 2023Published on 01 September 2019

The default network, which is automatically created with a hub, is a MQTT network. The default network, cannot be deleted.

Security & Identity (IAM):

You may need certain IAM permissions to carry out some actions described on this page. This means:

  • you are the Owner of the Scaleway Organization in which the actions will be carried out, or
  • you are an IAM user of the Organization, with a policy granting you the necessary permission sets
  1. Add a Hub device if you haven’t already done so.

    To keep this tutorial simple, choose to Allow Insercure connections. Insecure connections allow connections to the hub without encryption layer.

  2. Configure the physical device (or client) to connect through the network, using the following parameters:

    • Host: The network endpoint.
    • Port: Use 1883 for plaintext or 8883 for TLS.
    • MQTT Username: The device ID from the device you created earlier.
    • If your client asks for a password, just pass in an empty string.

    If you have configured your device to force mTLS (Deny Insecure connections), you will also need to provide the device certificate and private key, so that during the TLS handshake, the hub will be able to verify the device identity.

  3. Connect and exchange messages.

    Some networks support topic prefixes, but the default networks do not. The whole “topic space” is available to MQTT clients.

Read our introduction blog post to understand more about MQTT topics.

See Also