# Metabase

Both Metabase Cloud or self-hosted Metabase are supported.

To connect Dot to Metabase, follow these steps:

## **1. Generate an API Key in Metabase**

Metabase allows the creation of API keys to authenticate programmatic requests. To generate an API key:

1. Click on the gear icon in the upper right corner of Metabase.
2. Select **Admin settings**.
   1. ![](https://3709841693-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCeRlmJf2y704TpjpubE1%2Fuploads%2FCYFQsN3D6nGs5i4HUpaL%2Fimage.png?alt=media\&token=394721f2-fd0c-4f8f-9b72-b4cda94fc61c)
3. Navigate to the **Settings** tab.
4. Click on the **Authentication** tab in the left-hand menu.
5. Scroll to the **API Keys** section and click **Manage**.
6. Click the **Create API Key** button.
   1\.

   ```
   <figure><img src="https://3709841693-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCeRlmJf2y704TpjpubE1%2Fuploads%2FVDKeIMg1KkciUqHF34YD%2Fimage.png?alt=media&#x26;token=7c4054e5-7b81-49f1-883c-4ac40da8f8d0" alt=""><figcaption></figcaption></figure>
   ```
7. Enter a descriptive **Key name** to identify its purpose.
8. Select a **Group** to assign the key, determining its permissions.
9. Click **Create**.
10. Copy the generated API key and store it securely, as Metabase will not display it again.

## **2. Obtain the Metabase Server URL**

Identify the base URL of your Metabase instance. This is typically in the format `http://your-metabase-domain.com` or `https://your-metabase-domain.com`.

## **3. Connect Metabase to Dot**

In Dot, provide the Metabase Server URL and the API key you generated:

1. Open Dot and navigate to **Settings** / **Connections**.
2. Select the option to connect to Metabase.
3. Enter the **Server URL** (your Metabase base URL).
4. Input the **API Key** obtained from Metabase.
5. Click **Connect** to establish the integration.

<figure><img src="https://3709841693-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCeRlmJf2y704TpjpubE1%2Fuploads%2FNdYIoevN7J60h32PzYJf%2Fimage.png?alt=media&#x26;token=4401b052-22b5-4955-a5f4-35b0f1917feb" alt=""><figcaption></figcaption></figure>

Once connected, Dot will synchronize with Metabase. As soon as it's done, you can head over to **Model** / **External assets** to further curate what Dot should know about.

**Note:** Ensure that the API key has appropriate permissions assigned through its associated group in Metabase to allow Dot to access the necessary data.
