# Connect with OpenHAB

[OpenHAB,](https://www.openhab.org/) also known as open Home Automation Bus, is an open-source home automation software written in Java. With the strengths of integrating various devices, providing a clear user interface, and supporting the most flexible tools, openHAB becomes one of the most outstanding platforms in the field of home automation.

With the high flexibility and ease of use, openHAB provides a particular binding for users to connect MQTT Broker. In this article, we will introduce you to the process of setting up the EMQX Cloud MQTT Broker with openHAB.

## Prerequisites

Before connecting your OpenHAB application to the EMQX Cloud, ensure you have deployed an MQTT broker.

### Deploy MQTT Broker

<!-- @include: ./deploy_mqtt_broker.md -->

## OpenHAB Initialization

If you are using MQTT for OpenHAB for the first time, please refer to the [quick start](https://www.openhab.org/addons/bindings/mqtt/).

1. Install OpenHAB

   In this example, we use Docker to quickly install OpenHAB.

   ```bash
   docker run -d --name=openhab --restart=always --network=host \
    -v /opt/openhab/conf:/openhab/conf \
    -v /opt/openhab/userdata:/openhab/userdata \
    -v /opt/openhab/addons:/openhab/addons \
    openhab/openhab
   ```

   Then access the OpenHAB service via the local IP with the corresponding port, e.g., x.x.x.x:8080, to create an account.

   ![openhab_create_account](./_assets/openhab_create_account.png)

   Next, you can select language, region, time zone, location of your home. Once configuration is finished, you will be redirected to openHAB console.

   ![openhab_console](./_assets/openhab_console.png)

2. Install Bindings

   Go to `Settings` ---> `Bingdings` ---> `MQTT Binding` and install MQTT Binding:

   ![openhab_binding](./_assets/openhab_binding.png)

3. Add `MQTT Broker` to `Things`

   ![openhab_add_thing_1](./_assets/openhab_add_thing_1.png)

   Then select `MQTT Broker` and fill in the information of the deployment we created before.

   ![openhab_add_thing_2](./_assets/openhab_add_thing_2.png)

## Connect over TCP Port

This section describes how to connect an openhab client to MQTT broker over TCP port.

- Fill in the broker address, port, username and password (if it exists).
- Select `TCP` for MQTT transport.

![openhab_mqtt_connection](./_assets/openhab_mqtt_connection.png)

## Connect over TLS/SSL Port

This section describes how to connect an openhab client to MQTT broker over TLS/SSL port.

- Fill in the broker address, port, username, and password (if they exist).
- Enable `Secure Connection`.
- Select `TCP` for MQTT transport.

![openhab_mqtts_connection_1](./_assets/openhab_mqtts_connection_1.png)
![openhab_mqtts_connection_2](./_assets/openhab_mqtts_connection_2.png)

## Test Connection

Go to `Settings` ---> `Things` ---> `MQTT Broker`, when there is a little green label that says "online", you are successfully connecting openHAB with EMQX Cloud. Congrats!

![openhab_connection](./_assets/openhab_connection.png)

You can also check the status from the EMQX Cloud's monitor page.

![openhab_monitor](./_assets/openhab_monitor.png)