Documentation (Beta)
Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Back to homepage

Mqtt Gateway Onboarding

How to connect Gateway via MQTT

Prerequisites

  • Gateway Group is created and configured. For detailed description please see: GatewayGroup Setup
  • Gateway Model is created
  • Gateway is added and configured. For detailed description please see: Gateway Creating
  • To establish the connection with the gateway via SSH or KonaFT, gateway must be located in the same Local Area Network with PC/Laptop.

Gateway configuration Setup (Gateway side)

  1. Navigate to Gateway’s files.
  2. Navigate to /etc/default/tektelic-bridge.ns.toml file.
  3. Fill in the “host” with your Network Server host:
  • “host”: “lorawan-ns-eu.tektelic.com” for EU Network Server.
  • “host”: “lorawan-ns-na.tektelic.com” for NA Network Server.
  1. Fill in the “gw_username” with valid value.
    Newer gateways coming out of the factory have had their default MQTT credentials updated to use randomized character strings to increase security. These new default credentials can be found under the MQTT/OAM/Geolocation SERVER CREDENTIALS section of the test report sheet that is provided with your gateway.

  2. Fill in the “gw_password” with valid value.
    Newer gateways coming out of the factory have had their default MQTT credentials updated to use randomized character strings to increase security. These new default credentials can be found under the MQTT/OAM/Geolocation SERVER CREDENTIALS section of the test report sheet that is provided with your gateway.

    PLEASE NOTE: for older gateways you should use the old method of setting the MQTT passwords on the gateways:

    • Fill in the “gw_username” with valid value. The username consists of two parts TEK + 6 last symbols of Gateway ID (which can be found on the back side of the Gateway)
    • Fill in the “gw_password” with valid value. The password consists of 9 symbols that are similar to Gateway Serial Number (which can be found on the back side of the Gateway)
  3. Save changes.

  4. Reboot the mqtt bridge or reboot the Gateway.

Gateway configuration Setup (Network Server side)

  1. Navigate to the Network Server.
  2. Open your Gateway from the Gateways List.
  3. Press “Edit” button.
  4. Mark the checkbox “Allow not TLS MQTT” connection.
  5. Press “Apply Changes” button.
  6. Click on “Manage Credentials” button.
  7. Click “Show Password” button.
  8. Fill in the username with valid value (please see the “Gateway configuration Setup).
  9. Fill in the password with valid value (please see the “Gateway configuration Setup).
  10. Press “Save” button.
  11. Check Gateway’s Status. It should become online.