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

# DataHub CLI

> Push Bolt dbt™ artifacts—manifest, catalog, and run results—to DataHub for lineage and metadata ingestion using the paradime run datahub CLI command.

The Paradime SDK provides a CLI command to push Bolt dbt™ artifacts (manifest and catalog) to DataHub.

<Warning>
  🔑 **API Access Required**

  You will need your DataHub GMS server URL to use this command. A DataHub personal access token is required for DataHub Cloud / auth-enabled instances, and can be omitted for a local instance with metadata service auth disabled.
</Warning>

## Push DataHub Artifacts

Push Bolt dbt™ artifacts (manifest + catalog) to DataHub.

### CLI Command

```bash theme={"system"}
paradime run datahub-artifacts-push
```

#### Options

| Flag                             | Type           | Description                                                                                                                                                                                                                                 |
| -------------------------------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--datahub-server`               | Required, TEXT | The DataHub GMS server URL (e.g. https\://\<instance>.acryl.io/gms). Can be set via `DATAHUB_GMS_URL` environment variable.                                                                                                                 |
| `--datahub-token`                | Optional, TEXT | The DataHub personal access token used to authenticate to GMS. Required for DataHub Cloud / auth-enabled instances; omit for a local instance with metadata service auth disabled. Can be set via `DATAHUB_GMS_TOKEN` environment variable. |
| `--target-platform`              | Required, TEXT | The data warehouse platform the dbt models run on (e.g. snowflake, bigquery, redshift). Can be set via `DATAHUB_TARGET_PLATFORM` environment variable.                                                                                      |
| `--domain`                       | Optional, TEXT | Optional DataHub domain URN to associate the pushed assets with (e.g. urn:li:domain:sales). Can be set via `DATAHUB_DOMAIN` environment variable.                                                                                           |
| `--paradime-resources-directory` | Optional, TEXT | The directory where the paradime resources are stored. Can be set via `PARADIME_RESOURCES_DIRECTORY` environment variable.                                                                                                                  |
| `--json`                         | Optional, Flag | Output results as JSON. Default: `False`.                                                                                                                                                                                                   |
| `--help`                         | Optional, Flag | Show the help message and exit.                                                                                                                                                                                                             |

<Info>
  **Recommended Setup**

  For security and convenience, set your DataHub configuration as environment variables:

  ```bash theme={"system"}
  DATAHUB_GMS_URL="https://your-instance.acryl.io/gms"
  DATAHUB_GMS_TOKEN="your_personal_access_token"
  DATAHUB_TARGET_PLATFORM="snowflake"
  ```
</Info>

### Usage Example

```bash theme={"system"}
# Push dbt™ artifacts to DataHub (using environment variables)
paradime run datahub-artifacts-push

# Or with explicit flags
paradime run datahub-artifacts-push \
  --datahub-server "https://your-instance.acryl.io/gms" \
  --datahub-token "your_personal_access_token" \
  --target-platform "snowflake"
```

## Environment Variable Reference

| Environment Variable           | Description                                                     |
| ------------------------------ | --------------------------------------------------------------- |
| `DATAHUB_GMS_URL`              | The DataHub GMS server URL                                      |
| `DATAHUB_GMS_TOKEN`            | The DataHub personal access token used to authenticate to GMS   |
| `DATAHUB_TARGET_PLATFORM`      | The data warehouse platform the dbt models run on               |
| `DATAHUB_DOMAIN`               | Optional DataHub domain URN to associate the pushed assets with |
| `PARADIME_RESOURCES_DIRECTORY` | The directory where the paradime resources are stored           |


## Related topics

- [DataHub](/integrations/datahub.md)
- [datahub-sync](/products/bolt/creating-schedules/command-settings/datahub-sync.md)
- [Paradime CLI](/developers/paradime-cli/index.md)
- [GitHub Actions CLI](/developers/paradime-cli/github-actions-cli.md)
- [GitHub](/products/bolt/ci-cd/turbo-ci/github.md)