> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8c05c8a2.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-8c05c8a2/OjlyQCBF1Nqq9S7v/images/integrations/data-visualization/explo_15.png?fit=max&auto=format&n=OjlyQCBF1Nqq9S7v&q=85&s=cf3a9ed87fd47a7e9f78b0d962619ecd" 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-8c05c8a2/Yn9Ty-XK2U8NF3YT/images/_snippets/cloud-connect-button.png?fit=max&auto=format&n=Yn9Ty-XK2U8NF3YT&q=85&s=b686c12ce9557c68eca40985010c95e0" 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-8c05c8a2/Yn9Ty-XK2U8NF3YT/images/_snippets/connection-details-https.png?fit=max&auto=format&n=Yn9Ty-XK2U8NF3YT&q=85&s=8791490ebb8e7ab70bff1b5b8b3e39e8" 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-8c05c8a2/OjlyQCBF1Nqq9S7v/images/integrations/data-visualization/explo_01.png?fit=max&auto=format&n=OjlyQCBF1Nqq9S7v&q=85&s=e72733e4ad317d77180b4df499df756a" 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-8c05c8a2/OjlyQCBF1Nqq9S7v/images/integrations/data-visualization/explo_02.png?fit=max&auto=format&n=OjlyQCBF1Nqq9S7v&q=85&s=49844c40279d9cb7255455b1a6c980da" 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-8c05c8a2/OjlyQCBF1Nqq9S7v/images/integrations/data-visualization/explo_03.png?fit=max&auto=format&n=OjlyQCBF1Nqq9S7v&q=85&s=bacdc150c405bd91609b892a915c0373" 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-8c05c8a2/OjlyQCBF1Nqq9S7v/images/integrations/data-visualization/explo_04.png?fit=max&auto=format&n=OjlyQCBF1Nqq9S7v&q=85&s=6114cd040f469af19090cbf06875cc53" 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-8c05c8a2/OjlyQCBF1Nqq9S7v/images/integrations/data-visualization/explo_05.png?fit=max&auto=format&n=OjlyQCBF1Nqq9S7v&q=85&s=c5eb1a39ca9f1527f5ae71a72985f2f4" 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-8c05c8a2/OjlyQCBF1Nqq9S7v/images/integrations/data-visualization/explo_06.png?fit=max&auto=format&n=OjlyQCBF1Nqq9S7v&q=85&s=2c5b72d4c1b58a84d78af37d1bebe259" 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-8c05c8a2/OjlyQCBF1Nqq9S7v/images/integrations/data-visualization/explo_07.png?fit=max&auto=format&n=OjlyQCBF1Nqq9S7v&q=85&s=bf88fe54a0626fc05d052b4d0ebcc884" 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-8c05c8a2/OjlyQCBF1Nqq9S7v/images/integrations/data-visualization/explo_08.png?fit=max&auto=format&n=OjlyQCBF1Nqq9S7v&q=85&s=aa50d07990a58e29015e3486cba935f0" 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-8c05c8a2/OjlyQCBF1Nqq9S7v/images/integrations/data-visualization/explo_09.png?fit=max&auto=format&n=OjlyQCBF1Nqq9S7v&q=85&s=6fd2c375be0ddf8bdfb66ca05b7db054" 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-8c05c8a2/OjlyQCBF1Nqq9S7v/images/integrations/data-visualization/explo_10.png?fit=max&auto=format&n=OjlyQCBF1Nqq9S7v&q=85&s=60ffd62aa1a8e9e0a80b69f9cf60874c" 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-8c05c8a2/OjlyQCBF1Nqq9S7v/images/integrations/data-visualization/explo_11.png?fit=max&auto=format&n=OjlyQCBF1Nqq9S7v&q=85&s=580acdf584c56938b1d96a1d8d5aa4eb" 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-8c05c8a2/OjlyQCBF1Nqq9S7v/images/integrations/data-visualization/explo_16.png?fit=max&auto=format&n=OjlyQCBF1Nqq9S7v&q=85&s=16b79c7a6de07cd2d647b586df497d0a" 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-8c05c8a2/OjlyQCBF1Nqq9S7v/images/integrations/data-visualization/explo_12.png?fit=max&auto=format&n=OjlyQCBF1Nqq9S7v&q=85&s=2f392bf4f8fbd13163b67004164609a4" 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-8c05c8a2/OjlyQCBF1Nqq9S7v/images/integrations/data-visualization/explo_13.png?fit=max&auto=format&n=OjlyQCBF1Nqq9S7v&q=85&s=b71a4ee4dfb1cea57429a7fb91b3466e" 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-8c05c8a2/OjlyQCBF1Nqq9S7v/images/integrations/data-visualization/explo_14.png?fit=max&auto=format&n=OjlyQCBF1Nqq9S7v&q=85&s=89bc56cf2ea1a19b63c81ed5830fca27" 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-8c05c8a2/OjlyQCBF1Nqq9S7v/images/integrations/data-visualization/explo_15.png?fit=max&auto=format&n=OjlyQCBF1Nqq9S7v&q=85&s=cf3a9ed87fd47a7e9f78b0d962619ecd" 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>.
