> For the complete documentation index, see [llms.txt](https://docs.buildings.ability.abb/collection/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.buildings.ability.abb/collection/getting-started/2.-configure-edge-and-connect-via-openbos.md).

# 2. Configure the Building Edge and Connect via OpenBOS

This chapter explains how to connect a Building Edge site to BuildingPro Suites through the openBOS app.

Before you begin, make sure that:

* the Building Edge has been preconfigured and its organization is connected to a cloud portfolio; see [Check the Building Edge Configuration](/collection/getting-started/2.-configure-edge-and-connect-via-openbos/check-edge-configuration.md);
* you can access the corresponding tenant in BuildingPro Suites; see [Check License and Access Status](/collection/getting-started/1.-create-users-and-tenants/check-license-and-access-status.md); and
* a valid BuildingPro Suites license is available; see [Check License and Access Status](/collection/getting-started/1.-create-users-and-tenants/check-license-and-access-status.md);
* the **openBOS as a Service** and **openBOS Capacity** licenses have been activated and assigned to the Building Edge; see [Assign OpenBOS Licenses](/collection/getting-started/2.-configure-edge-and-connect-via-openbos/assign-openbos-licenses.md); and
* the openBOS app is available in the tenant; see [Open openBOS config](/collection/getting-started/2.-configure-edge-and-connect-via-openbos/open-openbos-config.md).

## Workflow

1. Check the Building Edge network, cloud connection, organization, licenses, assets, and API Subscriptions. Start by checking the Edge configuration and the data that should be provided to BuildingPro Suites. See [Check the Building Edge Configuration](/collection/getting-started/2.-configure-edge-and-connect-via-openbos/check-edge-configuration.md).
2. Associate the preconfigured Building Edge with a site in ABB Ability BuildingPro. After preconfiguring the Building Edge and setting up the organization, associate the site with the ABB Ability BuildingPro portfolio. See [Connect a Building Edge to BuildingPro as a Site](/collection/getting-started/2.-configure-edge-and-connect-via-openbos/associate-site.md).
3. Assign the **openBOS as a Service** and **openBOS Capacity** licenses to the Building Edge. Before opening the *openBOS* configuration, assign both required licenses to the Building Edge. See [Assign OpenBOS Licenses](/collection/getting-started/2.-configure-edge-and-connect-via-openbos/assign-openbos-licenses.md).
4. Get the Edge Identification Number from the configured site in ABB Ability BuildingPro. Retrieve the Edge Identification Number before configuring the Edge connection. See [Configure OpenBOS](/collection/getting-started/2.-configure-edge-and-connect-via-openbos/configure-openbos.md).
5. Open the openBOS app in BuildingPro Suites and make sure that it is activated. Open the app through **Platform Core -> Connect Hub -> Edge/App Marketplace for plug-ins & extensions -> openBOS** and activate it if necessary. See [Open openBOS config](/collection/getting-started/2.-configure-edge-and-connect-via-openbos/open-openbos-config.md).
6. Select the required site and open its site configuration. Select the site in the app and open **Sites Config**. See [Open openBOS config](/collection/getting-started/2.-configure-edge-and-connect-via-openbos/open-openbos-config.md).
7. Configure the Edge Identification Number and the tree structure that should be synchronized to BuildingPro Suites. After opening the site configuration, configure the Edge connection and select the tree structure to synchronize. See [Configure OpenBOS](/collection/getting-started/2.-configure-edge-and-connect-via-openbos/configure-openbos.md).

For the complete openBOS configuration reference, including Edge preparation, API subscriptions, gateway configuration, and Continuous Asset Creation, see [OpenBOS](/collection/mandatory-base/platform-core/connect-hub/edge-app-marketplace-for-plug-ins-and-extentions/apps/openbos.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.buildings.ability.abb/collection/getting-started/2.-configure-edge-and-connect-via-openbos.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.