+++
title = "Using ElasticHQ with Bonsai"
weight = 133
updated = 2023-07-07
aliases = ["/docs/using-elastichq-with-bonsai", "/docs/managed-search/elasticsearch-and-opensearch/cluster-management/integrations/elastichq/", "/docs/cluster-management/integrations/elastichq/"]

[extra]
weight = 51
nav_title = "ElasticHQ"
+++

Bonsai supports the [ElasticHQ](https://github.com/ElasticHQ/elasticsearch-HQ) monitoring and management interface. This open source software gives you insight into the
state of your cluster. If you're looking to see details about performance, check
out [Cluster Metrics](@/docs/features/cluster-overview/index.md).

{{ image(src="cluster-metrics.png", alt="Cluster Metrics", automatically_determine_ratio=true) }}

The [GitHub repo](https://github.com/ElasticHQ/elasticsearch-HQ) has tons of documentation and how-to guides. This
article lays out some common methods of running ElasticHQ locally.

## Using OS X with Pow

```bash
mkdir -p ~/.pow/elastichq
git clone git@github.com:royrusso/elasticsearch-HQ.git ~/.pow/elastichq/public
```

Navigate your browser to http://elastichq.dev/. You should see the ElasticHQ dashboard. Enter your Bonsai cluster URL in
the field for the cluster location and click on “Connect.” The dashboard will bring up information about your cluster.

## Using Grunt

```bash
git clone git@github.com:royrusso/elasticsearch-HQ.git
cd elasticsearch-HQ
git checkout master
npm install
grunt server
```

You should see the ElasticHQ dashboard at http://localhost:9000/. Enter your bonsai.io cluster URL in the field for the
cluster location and click on “Connect.” The dashboard will bring up information about your cluster.

## Using Apache

First, make sure Apache is running. Typically this means you can access a directory via your browser
at http://localhost:80/. Your install may be different, so use whatever URL/folder is appropriate for you.

```bash
cd # The root directory of your HTTP server
git clone git@github.com:royrusso/elasticsearch-HQ.git
cd elasticsearch-HQ/
git checkout master
```

Open up your browser to http://localhost:80/elasticsearch-HQ/ and you should see the ElasticHQ dashboard. Enter your
bonsai.io cluster URL in the field for the cluster location and click on “Connect.” The dashboard will bring up
information about your cluster.