> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oleander.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# dbt

> Configure oleander with dbt

## Overview

The OpenLineage integration for dbt captures lineage metadata from your data transformations automatically.
A comprehensive guide on how to configure and use the OpenLineage integration with dbt can be found at
[OpenLineage documentation](https://openlineage.io/docs/integrations/dbt).

## Getting Started

### Requirements

* Python 3.8+
* An existing [dbt](https://www.getdbt.com/) project

### Install

Install the OpenLineage dbt wrapper:

```bash theme={null}
pip install openlineage-dbt
```

### oleander API Key

Go to [`https://oleander.dev`](https://oleander.dev), then copy your [API key](https://oleander.dev/app/settings/api-key).

### Configure

Set the following environment variables:

```bash theme={null}
export OPENLINEAGE_URL=https://oleander.dev
export OPENLINEAGE_API_KEY=[OLEANDER-API-KEY]
```

### Run

Replace your usual `dbt run` command with `dbt-ol` to begin collecting lineage metadata:

```bash theme={null}
dbt-ol run
```

The `dbt-ol` wrapper supports all standard dbt commands. For example:

```bash theme={null}
dbt-ol test
dbt-ol build
dbt-ol seed
```

Finally, go to [`https://oleander.dev`](https://oleander.dev) to view the OpenLineage events emitted by your dbt models.