--- updatedAt: 2026-04-17T07:04:59.000Z agentTools: projectIndex: https://esf.eurotech.com/llms.txt --- # Everyware Cloud Connection Everyware Cloud provides an easy mechanism for connecting cloud-ready devices to IT systems and/or applications; therefore, connecting to Everyware Cloud is an important step in creating and maintaining a complete M2M application. Information on Everyware Cloud and its features can be found here. This document outlines how to connect to Everyware Cloud using the ESF Gateway Administrative Console. # Using the ESF Gateway Administrative Console The ESF Gateway Administrative Console exposes all services necessary for connecting to Everyware Cloud. The reference links listed below outline each service involved in the Everyware Cloud connection. It is recommended that each section be reviewed. * [CloudService](https://esf.eurotech.com/docs/configure-everyware-cloud-connection#section-cloudservice) * [MqttDataTransport](https://esf.eurotech.com/docs/configure-everyware-cloud-connection#section-mqttdatatransport) * [DataService](https://esf.eurotech.com/docs/configure-everyware-cloud-connection#section-dataservice) ## CloudService The default settings for the CloudService are typically adequate for connecting to Everyware Cloud. The screen capture shown below displays the default settings for the CloudService. For details about each setting, please refer to [CloudService](https://esf.eurotech.com/docs/cloud-service). ![2414](https://files.readme.io/f7ed088-ESF_CloudService.png "ESF_CloudService.png") > 🚧 The **Simple JSON** payload encoding is not supported by Everyware Cloud. Use the default **Kura Protobuf** encoding instead. ## MqttDataTransport 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 Eurotech Everyware Cloud account was established. Information on how to obtain the broker URL can be found [here](http://everywarecloud.eurotech.com/doc/ECDevGuide/latest/2.02-Managing-Cloud-Users.asp). In the MqttDataTransport configuration screen capture shown below, the *broker-url* is **mqtts\://broker-sandbox.everyware-cloud.com:8883/**. > 🚧 An SSL connection (mqtts on port 8883) is required for all Eurotech devices and any device using the ESF security features. > 🚧 To use an SSL connection (mqtts on port 8883) with the ESF developer environment, a proper keystore has to be provided and linked via the ESF web UI. Please refer to [SSL Configuration](https://esf.eurotech.com/docs/ssl-configuration) for further details. * **topic.context.account-name** - defines the account name of the account to which the device is attempting to connect. In the MqttDataTransport configuration screen capture shown below, the *account name* is **ec-account-name**. * **username** - identifies the user to be used when creating the connection. In the MqttDataTransport configuration screen capture shown below, the *username* is **ec-account-name-broker**. > 🚧 When connecting to Everyware Cloud, the *username* must have proper permissions. Information on users and permissions can be found [here](http://everywarecloud.eurotech.com/doc/ECDevGuide/latest/2.02-Managing-Cloud-Users.asp). * **clean-session** - controls whether the client starts a clean session when connecting to the broker. > 🚧 When establishing a connection to Everyware Cloud, the **clean-session** flag in the **MqttDataTransport** configuration must be set to **true**. Setting it to **false** is not supported and may cause connection issues or unexpected behavior. For complete details about the MqttDataTransport configuration parameters, please refer to [MqttDataTransport](https://esf.eurotech.com/docs/mqttdata-transport-service-configuration). ![1214](https://files.readme.io/b75184d-ESF_Mqtt.png "ESF_Mqtt.png") ## DataService 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](https://esf.eurotech.com/docs/data-service). In order for ESF to connect to Everyware Cloud on startup, the *connect.auto-on-startup* 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 *connect.auto-on-startup* option to true. > 🚧 Changing the value of *connect.auto-on-startup* 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. ![1214](https://files.readme.io/160c870-ESF_DataService.png "ESF_DataService.png") # Connect/Disconnect 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 *connect.auto-on-startup* DataService setting.