> For the complete documentation index, see [llms.txt](https://learn.heeler.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.heeler.com/tenant-admin-guide/connections/brokers.md).

# Brokers

## On-Premises Brokers

A **Broker** is an on-premises agent that lets Heeler reach private container registries and Kubernetes clusters inside your network. The broker establishes an outbound connection to Heeler, so you don't need to open inbound firewall rules.

### Where to find it

Administration → **Connections** → **Brokers** in the left sidebar.

URL: `https://app.heeler.com/administration/connections/broker`

### Quick start

[See the On-Premises Broker documentation](/getting-started/code-setup/on-premises-broker.md).

### Reference

#### Table columns

| Column                 | Description                                                                  |
| ---------------------- | ---------------------------------------------------------------------------- |
| **Broker Details**     | Broker name and identifier.                                                  |
| **Broker Connections** | Which Heeler connections (SCMs, registries, etc.) route through this broker. |
| **Instance Count**     | Number of broker instances reporting in (for HA deployments).                |
| **Broker Status**      | Active / inactive.                                                           |
| **Outbound Contact**   | Last outbound check-in from the broker.                                      |
| **Inbound Contact**    | Last inbound request Heeler made through the broker.                         |

#### Actions

* **Add Broker** — create a new broker configuration and download deployment artifacts.
* Clicking a row opens detail including connected resources, version, and the ability to rotate credentials.

### When to use a broker

You need a broker if your registry (e.g., on-prem Artifactory) or Kubernetes clusters aren't publicly accessible.


---

# 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:

```
GET https://learn.heeler.com/tenant-admin-guide/connections/brokers.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.