Eclipse Kapua Connection

Eclipse Kapua™ is a modular platform providing the services required to manage IoT gateways and smart edge devices. Kapua provides a core integration framework and an initial set of core IoT services including a device registry, device management services, messaging services, data management, and application enablement. More information can be found here. This document outlines how to connect to Eclipse Kapua using the ESF Gateway Administrative Console.

Using the ESF Gateway Administrative Console

The ESF Gateway Administrative Console exposes all services necessary for connecting to Eclipse Kapua. The reference links listed below outline each service involved in the connection. It is recommended that each section be reviewed.


The default settings for the CloudService are typically adequate for connecting to Eclipse Kapua. The screen capture shown below displays the default settings for the CloudService. For details about each setting, please refer to CloudService.



While the majority of default settings in the MqttDataTransport can be left unchanged, the following parameters must be modified:

  • broker-url - defines the MQTT broker URL that was provided when the Eclipse Kapua account was established. Information on how to obtain the broker URL can be found here. In the MqttDataTransport configuration screen capture shown below, the broker-url is mqtts://????:8883/.

  • topic.context.account-name - defines the account name of the account to which the device is attempting to connect.

  • username - identifies the user to be used when creating the connection.

For complete details about the MqttDataTransport configuration parameters, please refer to MqttDataTransport.



The majority of default settings in the DataService can be left unchanged. A screen capture of the DataService configuration is shown below. For complete details about the DataService configuration parameters, please refer to DataService.

In order for ESF to connect to Eclipse Kapua on startup, the option must be set to true. If this value is changed from false to true, ESF will immediately begin the connection process. It is recommended that the CloudService and MqttDataTransport are configured before setting the option to true.


Changing the value of from true to false will not disconnect the client from the broker. This setting simply implies that ESF will not automatically connect on the next start of ESF.



The status panel can be used to manually connect or disconnect the client while ESF is running. The main button toolbar has a connect and disconnect button that may be used to control connectivity.


Connecting or disconnecting the client via the status panel has no impact on ESF automatically connecting at startup. This capability is only controlled via the DataService setting.