> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-a804b3ad.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-a804b3ad/MegT1UTz0VhkdAkl/images/integrations/data-visualization/explo_15.png?fit=max&auto=format&n=MegT1UTz0VhkdAkl&q=85&s=61a721be4a2ed2117ff068bedd7165b3" 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-a804b3ad/daBhXl5XtKWCwD8z/images/_snippets/cloud-connect-button.png?fit=max&auto=format&n=daBhXl5XtKWCwD8z&q=85&s=82b4154e6a183c6abc449c7b38a5ba43" 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-a804b3ad/daBhXl5XtKWCwD8z/images/_snippets/connection-details-https.png?fit=max&auto=format&n=daBhXl5XtKWCwD8z&q=85&s=a87d49c2093eac2e430f5546349a4969" 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-a804b3ad/MegT1UTz0VhkdAkl/images/integrations/data-visualization/explo_01.png?fit=max&auto=format&n=MegT1UTz0VhkdAkl&q=85&s=52f1ea8cc1153a424bc44af071dd7af6" 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-a804b3ad/MegT1UTz0VhkdAkl/images/integrations/data-visualization/explo_02.png?fit=max&auto=format&n=MegT1UTz0VhkdAkl&q=85&s=65c2d54f94ee5052c3162b4c2c216ca0" 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-a804b3ad/MegT1UTz0VhkdAkl/images/integrations/data-visualization/explo_03.png?fit=max&auto=format&n=MegT1UTz0VhkdAkl&q=85&s=af13de33b519a898d1a588d01027cfa8" 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-a804b3ad/MegT1UTz0VhkdAkl/images/integrations/data-visualization/explo_04.png?fit=max&auto=format&n=MegT1UTz0VhkdAkl&q=85&s=f1436deeac3a5b029fcfff0ba3799c8d" 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-a804b3ad/MegT1UTz0VhkdAkl/images/integrations/data-visualization/explo_05.png?fit=max&auto=format&n=MegT1UTz0VhkdAkl&q=85&s=9d4049c3be76ce2d965b3e0879a417f5" 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-a804b3ad/MegT1UTz0VhkdAkl/images/integrations/data-visualization/explo_06.png?fit=max&auto=format&n=MegT1UTz0VhkdAkl&q=85&s=c7bde42a50d6ed484a67bfa166916b1c" 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-a804b3ad/MegT1UTz0VhkdAkl/images/integrations/data-visualization/explo_07.png?fit=max&auto=format&n=MegT1UTz0VhkdAkl&q=85&s=271cbd65eca9dcf3ef5dcaabbcaa38d3" 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-a804b3ad/MegT1UTz0VhkdAkl/images/integrations/data-visualization/explo_08.png?fit=max&auto=format&n=MegT1UTz0VhkdAkl&q=85&s=17590dd4b73222f99d272bd08967acc3" 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-a804b3ad/MegT1UTz0VhkdAkl/images/integrations/data-visualization/explo_09.png?fit=max&auto=format&n=MegT1UTz0VhkdAkl&q=85&s=07609c44938821cd95d5c080882d49ac" 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-a804b3ad/MegT1UTz0VhkdAkl/images/integrations/data-visualization/explo_10.png?fit=max&auto=format&n=MegT1UTz0VhkdAkl&q=85&s=65e1016aecc293cf5d624f69ebc0a0a2" 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-a804b3ad/MegT1UTz0VhkdAkl/images/integrations/data-visualization/explo_11.png?fit=max&auto=format&n=MegT1UTz0VhkdAkl&q=85&s=ca143f9a866d951aed9e4c29bd2d7570" 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-a804b3ad/MegT1UTz0VhkdAkl/images/integrations/data-visualization/explo_16.png?fit=max&auto=format&n=MegT1UTz0VhkdAkl&q=85&s=0529516cf4c84bd4b3fac3b3b56ba437" 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-a804b3ad/MegT1UTz0VhkdAkl/images/integrations/data-visualization/explo_12.png?fit=max&auto=format&n=MegT1UTz0VhkdAkl&q=85&s=ef24e493fb8a7513b4ef1acccb21256b" 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-a804b3ad/MegT1UTz0VhkdAkl/images/integrations/data-visualization/explo_13.png?fit=max&auto=format&n=MegT1UTz0VhkdAkl&q=85&s=fa1327718a4895ddd1eda424199f0680" 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-a804b3ad/MegT1UTz0VhkdAkl/images/integrations/data-visualization/explo_14.png?fit=max&auto=format&n=MegT1UTz0VhkdAkl&q=85&s=afa59410542bf185e652bcdcf58e4e31" 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-a804b3ad/MegT1UTz0VhkdAkl/images/integrations/data-visualization/explo_15.png?fit=max&auto=format&n=MegT1UTz0VhkdAkl&q=85&s=61a721be4a2ed2117ff068bedd7165b3" 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>.
