> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Explo is an easy-to-use, open source UI tool for asking questions about your data.

# Connecting Explo to ClickHouse

export const CommunityMaintainedBadge = () => {
  return <div className="CommunityMaintainedBadge">
            <div className="CommunityMaintainedIcon">
            <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" fill="currentColor" viewBox="0 0 256 256">
                <path d="M244.8,150.4a8,8,0,0,1-11.2-1.6A51.6,51.6,0,0,0,192,128a8,8,0,0,1-7.37-4.89,8,8,0,0,1,0-6.22A8,8,0,0,1,192,112a24,24,0,1,0-23.24-30,8,8,0,1,1-15.5-4A40,40,0,1,1,219,117.51a67.94,67.94,0,0,1,27.43,21.68A8,8,0,0,1,244.8,150.4ZM190.92,212a8,8,0,1,1-13.84,8,57,57,0,0,0-98.16,0,8,8,0,1,1-13.84-8,72.06,72.06,0,0,1,33.74-29.92,48,48,0,1,1,58.36,0A72.06,72.06,0,0,1,190.92,212ZM128,176a32,32,0,1,0-32-32A32,32,0,0,0,128,176ZM72,120a8,8,0,0,0-8-8A24,24,0,1,1,87.24,82a8,8,0,1,0,15.5-4A40,40,0,1,0,37,117.51,67.94,67.94,0,0,0,9.6,139.19a8,8,0,1,0,12.8,9.61A51.6,51.6,0,0,1,64,128,8,8,0,0,0,72,120Z"></path>
            </svg>
        </div>
            Community Maintained
        </div>;
};

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

Customer-facing analytics for any platform. Designed for beautiful visualization. Engineered for simplicity.

<h2 id="goal">
  Goal
</h2>

In this guide you will connect your data from ClickHouse to Explo and visualize the results.  The chart will look like this:

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_15.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=358e10822bedcdaff7031bd3ebde6ab3" size="md" alt="Explo Dashboard" width="1152" height="661" data-path="images/integrations/data-visualization/explo_15.png" />

<p />

<Tip>
  **Add some data**

  If you don't have a dataset to work with you can add one of the examples.  This guide uses the [UK Price Paid](/get-started/sample-datasets/uk-price-paid) dataset, so you might choose that one.  There are several others to look at in the same documentation category.
</Tip>

<h2 id="1-gather-your-connection-details">
  1. Gather your connection details
</h2>

To connect to ClickHouse with HTTP(S) you need this information:

| Parameter(s)              | Description                                                                                                    |
| ------------------------- | -------------------------------------------------------------------------------------------------------------- |
| `HOST` and `PORT`         | Typically, the port is 8443 when using TLS or 8123 when not using TLS.                                         |
| `DATABASE NAME`           | Out of the box, there is a database named `default`, use the name of the database that you want to connect to. |
| `USERNAME` and `PASSWORD` | Out of the box, the username is `default`. Use the username appropriate for your use case.                     |

The details for your ClickHouse Cloud service are available in the ClickHouse Cloud console.
Select a service and click **Connect**:

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/Qke-GQkmVyWEhvPu/images/_snippets/cloud-connect-button.png?fit=max&auto=format&n=Qke-GQkmVyWEhvPu&q=85&s=a41d53ce6c46ccccb2855331a8dcc841" size="md" alt="ClickHouse Cloud service connect button" border width="998" height="932" data-path="images/_snippets/cloud-connect-button.png" />

Choose **HTTPS**. Connection details are displayed in an example `curl` command.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/Qke-GQkmVyWEhvPu/images/_snippets/connection-details-https.png?fit=max&auto=format&n=Qke-GQkmVyWEhvPu&q=85&s=0377c34215bd524b359c0d20dd96bed3" size="md" alt="ClickHouse Cloud HTTPS connection details" border width="1320" height="1184" data-path="images/_snippets/connection-details-https.png" />

If you're using self-managed ClickHouse, the connection details are set by your ClickHouse administrator.

<h2 id="2--connect-explo-to-clickhouse">
  2. Connect Explo to ClickHouse
</h2>

1. Sign up for an Explo account.

2. Click on the Explo **data** tab on the left hand sidebar.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_01.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=2b8befd0ad6f4f84ce545d639c3841bd" size="sm" alt="Data Tab" border width="432" height="500" data-path="images/integrations/data-visualization/explo_01.png" />

3. Click **Connect Data Source** in the upper right hand side.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_02.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=f59691ee8b48672916dfab115715c002" size="sm" alt="Connect Data Source" border width="288" height="78" data-path="images/integrations/data-visualization/explo_02.png" />

4. Fill out the information on the **Getting Started** page

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_03.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=40147492e5d21af193ff3e0370d994d6" size="md" alt="Getting Started" border width="1152" height="894" data-path="images/integrations/data-visualization/explo_03.png" />

5. Select **Clickhouse**

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_04.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=f7d9330c2bea29ca4049eb80c72c1baf" size="md" alt="Clickhouse" border width="1152" height="1156" data-path="images/integrations/data-visualization/explo_04.png" />

6. Enter your **Clickhouse Credentials**.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_05.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=fff4edbdac9cfb92d3cf5c3412518993" size="md" alt="Credentials" border width="1152" height="902" data-path="images/integrations/data-visualization/explo_05.png" />

7. Configure **Security**

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_06.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=67f527737d9544798f54669363ef86d6" size="md" alt="Security" border width="1152" height="855" data-path="images/integrations/data-visualization/explo_06.png" />

8. Within Clickhouse, **Whitelist the Explo IPs**.
   `54.211.43.19, 52.55.98.121, 3.214.169.94, and 54.156.141.148`

<h2 id="3-create-a-dashboard">
  3) Create a Dashboard
</h2>

1. Navigate to **Dashboard** tab on the left side nav bar.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_07.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=fb2a0b629bbb4cdb53966b6b75fff589" size="sm" alt="Dashboard" border width="432" height="891" data-path="images/integrations/data-visualization/explo_07.png" />

2. Click **Create Dashboard** in the upper right corner and name your dashboard. You've now created a dashboard!

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_08.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=45bfe1a4f1e1aee253028e1a8fd6e389" size="sm" alt="Create Dashboard" border width="425" height="76" data-path="images/integrations/data-visualization/explo_08.png" />

3. You should now see a screen that is similar to this:

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_09.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=8f5b739f79f100fe72d9fb422967afee" size="md" alt="Explo Dashboard" border width="1152" height="688" data-path="images/integrations/data-visualization/explo_09.png" />

<h2 id="4-run-a-sql-query">
  4. Run a SQL query
</h2>

1. Get your table name from the right hand sidebar under your schema title. You should then put the following command into your dataset editor:
   `SELECT * FROM YOUR_TABLE_NAME
   LIMIT 100`

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_10.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=0777235055db63a24ddf13efa516c7da" size="md" alt="Explo Dashboard" border width="1152" height="284" data-path="images/integrations/data-visualization/explo_10.png" />

2. Now click run and go to the preview tab to see your data.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_11.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=b0467229ca5f6012fdcbdffb25226662" size="md" alt="Explo Dashboard" border width="1152" height="329" data-path="images/integrations/data-visualization/explo_11.png" />

<h2 id="5-build-a-chart">
  5. Build a Chart
</h2>

1. From the left hand side, drag the bar chart icon onto the screen.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_16.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=90b4a81ac793a8d5c6edec9ffda759ea" size="sm" alt="Explo Dashboard" border width="432" height="978" data-path="images/integrations/data-visualization/explo_16.png" />

2. Select the dataset. You should now see a screen like the following:

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_12.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=1b085c463a9702ce95086e637c781df3" size="sm" alt="Explo Dashboard" border width="432" height="744" data-path="images/integrations/data-visualization/explo_12.png" />

3. Fill out the **county** in the X Axis and **Price** in the Y Axis Section like so:

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_13.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=0275751e33aaa27fa4f1fd0c755149b9" size="sm" alt="Explo Dashboard" border width="432" height="754" data-path="images/integrations/data-visualization/explo_13.png" />

4. Now, change the aggregation to **AVG**.

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_14.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=6e01a23fb57792c32df8f4c8ac41788b" size="sm" alt="Explo Dashboard" border width="432" height="447" data-path="images/integrations/data-visualization/explo_14.png" />

5. We now have average price of homes broken down by price!

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/5u7Mhe0xzzPTUaXM/images/integrations/data-visualization/explo_15.png?fit=max&auto=format&n=5u7Mhe0xzzPTUaXM&q=85&s=358e10822bedcdaff7031bd3ebde6ab3" size="md" alt="Explo Dashboard" width="1152" height="661" data-path="images/integrations/data-visualization/explo_15.png" />

<h2 id="learn-more">
  Learn more
</h2>

Find more information about Explo and how to build dashboards by <a href="https://docs.explo.co/" target="_blank">visiting the Explo documentation</a>.
