# Configure client

The broker is configured in the broker details

In the broker details you can:

*  Establish a connection to a broker
* adjust the existing connection data of the selected broker
* [↗ Create a subscription](/collection/english-v14/connectivity-as-a-service/connect-devices-with-abb-buildingpro/connect-devices-via-mqtt/configure-a-subscription.md)

## Overview

<div data-full-width="true"><figure><img src="/files/6e2397fb856d7977830aa6c1ef498ac54bd4a2b3" alt=""><figcaption><p>Fig. 1 – The broker details</p></figcaption></figure></div>

<table><thead><tr><th width="95.33333333333331">Icon</th><th width="297">Description</th><th>Details</th></tr></thead><tbody><tr><td><strong>[A]</strong></td><td>Section “Connection”</td><td>In this section, the broker’s connection data is configured</td></tr><tr><td><strong>[A1]</strong></td><td>Name</td><td>A name for the connection. This name is used to appear in the broker list</td></tr><tr><td><strong>[A2]</strong></td><td>Client ID</td><td>Enter a client ID. The MQTT broker uses the client ID to detect when a client reconnects and to close any existing TCP connections if necessary.</td></tr><tr><td><strong>[A3]</strong></td><td>Host</td><td>Enter the host address of the broker to which you want to establish a connection here</td></tr><tr><td><strong>[A4]</strong></td><td>Port</td><td>Enter the port of the broker here. Usually (1883)</td></tr><tr><td><strong>[A5]</strong></td><td>Login</td><td>Enter the username for the broker here</td></tr><tr><td><strong>[A6]</strong></td><td>Password</td><td>Enter the password for the broker here</td></tr><tr><td><strong>[A7]</strong></td><td>More options</td><td>Click to show or hide more options</td></tr><tr><td><strong>[A8]</strong></td><td>Keep Alive</td><td>This value indicates how much time passes between two value transmissions until a client asks the broker whether it is still active.</td></tr><tr><td><strong>[A9]</strong></td><td>SOCKS5 proxy</td><td>You can configure a proxy server</td></tr><tr><td><strong>[A10]</strong></td><td>Host</td><td>Specify the SOCKS5 host</td></tr><tr><td><strong>[A11]</strong></td><td>Port</td><td>Specify the SOCKS5 port</td></tr><tr><td><strong>[A12]</strong></td><td>Username</td><td>Specify the SOCKS5 username</td></tr><tr><td><strong>[A13]</strong></td><td>Password</td><td>Specify the SOCKS5 password</td></tr><tr><td><strong>[A14]</strong></td><td>Save</td><td>Click to save</td></tr><tr><td><strong>[B]</strong></td><td>Subscriptions</td><td>This area displays all subscriptions available for the selected broker.</td></tr><tr><td><strong>[B1]</strong></td><td>Create subscription</td><td>Click this button to create a new subscription for this broker</td></tr><tr><td><strong>[B2]</strong></td><td>Edit subscription</td><td>Click this button to subsequently edit the corresponding subscription</td></tr><tr><td><strong>[C]</strong></td><td>Publications</td><td>This area displays all publications available for the selected broker</td></tr><tr><td><strong>[C1]</strong></td><td>Create publication</td><td>Click this button to create a new publication for this broker</td></tr><tr><td><strong>[C2]</strong></td><td>Edit publication</td><td>Click this button to subsequently edit the corresponding publication</td></tr><tr><td><strong>[D]</strong></td><td>Connection status</td><td>This area shows whether Eliona’s connection status to the current broker is good</td></tr><tr><td><strong>[D1]</strong></td><td>Test connection</td><td>Click here to test the connection to the broker</td></tr><tr><td><strong>[D2]</strong></td><td>Connection status</td><td>The connection status to the current broker is shown here</td></tr><tr><td></td><td></td><td></td></tr></tbody></table>

## Configure broker

If you have just created the broker, the data under **\[A]** is empty.

Fill in the data and click on **Save \[A14]**&#x74;o save the settings.

Check the connection if necessary (see next point).

## Check connection

You can check whether the connection to the selected MQTT broker is valid.

1. Click on **\[D1]**\
   ▷ Under **\[D2]** the current connection status is displayed

## Create new subscription

1. Click on **\[B1]** to create a new subscription\
   ▷ The window [↗ Configure subscription opens](/collection/english-v14/connectivity-as-a-service/connect-devices-with-abb-buildingpro/connect-devices-via-mqtt/configure-a-subscription.md) . Continue as described there.

## Create new publication

1. Click on **\[C1]** to create a new publication \
   ▷ The window [↗ Configure publication](/collection/english-v14/connectivity-as-a-service/connect-devices-with-abb-buildingpro/connect-devices-via-mqtt/configure-a-publication.md) opens. Continue as described there.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.buildings.ability.abb/collection/english-v14/connectivity-as-a-service/connect-devices-with-abb-buildingpro/connect-devices-via-mqtt/configure-client.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.