> For the complete documentation index, see [llms.txt](https://developer.collibra.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.collibra.com/cli/cli.md).

# Collibra CLI

The Collibra CLI is a unified command-line tool that packages API calls, allowing you to manage your Collibra products directly from the terminal. You can use it to interact with your environment manually or integrate it into automation workflows.

The CLI is a shared utility that supports multiple Collibra features. Once installed and configured, you can use it to perform actions such as registering AI model versions and managing data contracts, among others.

## Prerequisites

* You have a Collibra account with the permissions required for the actions you want to perform.

### Requirements for organizations using SSO

If your organization signs into Collibra via SSO (SAML2 or OAuth), your SSO credentials cannot be used to authenticate with the CLI. You need a dedicated local account instead.

1. Ask your Collibra administrator to create a dedicated user account directly in your Collibra environment, bypassing SSO.
2. Assign the permissions required for the actions you want to perform to the new account.
3. When the account is created, you receive an invitation email. Click the link in the email to activate the account and set your password.
4. Use these dedicated local credentials when authenticating with the CLI.

## Install the CLI

{% stepper %}
{% step %}
Download the CLI binary from [GitHub](https://github.com/collibra/collibra-cli-releases) and extract it. Choose the file for your operating system and processor:

* **Windows amd64**: for most Windows machines.
* **Windows arm64**: for Surface and similar devices.
* **Linux amd64**: for most Linux machines.
* **Linux arm64**: for Linux machines with ARM architecture.
* **darwin-macos all**: for Mac.
  {% endstep %}

{% step %}
Open your terminal or command prompt and navigate to the folder where you saved the downloaded file:

* Windows: `cd C:\Users\YourUserName\Downloads`
* Linux or Mac: `cd ~/Downloads`
  {% endstep %}

{% step %}
Extract the binary:

* Windows: `tar -xf collibra-x.x.x-windows_xxx64.zip`
* Linux: `tar -xf collibra-x.x.x-linux_xxx64.tar.gz`
* Mac: `unzip collibra-x.x.x-darwin-macos_all.zip`
  {% endstep %}

{% step %}
Mac only: if your Mac prevents the binary from running because the developer is not verified, allow it through macOS security:

1. Go to **System Settings** → **Privacy & Security**.
2. Find the message about the `collibra` file being blocked and click Open Anyway.

Alternatively, run the following command to remove the quarantine flag: `xattr -d com.apple.quarantine <file>`.

The current version is pending an official Apple signing key. This is a standard macOS security prompt and does not indicate a problem with the file.
{% endstep %}

{% step %}
Confirm the binary works by running it without any arguments:

* Windows: `.\collibra`
* Linux or Mac: `./collibra`

A help message is shown, listing the available commands.
{% endstep %}
{% endstepper %}

## Configure the CLI

Before you can run any commands, set the following environment variables so the CLI can connect to your Collibra environment. Replace the placeholder values with your actual credentials.

{% tabs %}
{% tab title="Windows CMD" %}

```batch
SET COLLIBRA_URL=https://<YourCollibraEnvironment>.collibra.com
SET COLLIBRA_USERNAME=<YourUsername>
SET COLLIBRA_PASSWORD=<YourPassword>
```

{% endtab %}

{% tab title="Windows PowerShell" %}

```powershell
$env:COLLIBRA_URL="https://<YourCollibraEnvironment>.collibra.com"
$env:COLLIBRA_USERNAME="<YourUsername>"
$env:COLLIBRA_PASSWORD="<YourPassword>"
```

{% endtab %}

{% tab title="Mac and Linux" %}

```bash
export COLLIBRA_URL='https://<YourCollibraEnvironment>.collibra.com'
export COLLIBRA_USERNAME='<YourUsername>'
export COLLIBRA_PASSWORD='<YourPassword>'
```

{% endtab %}
{% endtabs %}

The environment variables set this way are temporary and apply only to the current terminal session. To make them permanent, add the same lines to your shell configuration file, such as `~/.bashrc`, `~/.zshrc`, or `~/.bash_profile`, then restart your terminal.

If your organization uses a proxy, add the `https_proxy` variable alongside the others, for example:

```bash
export https_proxy='https://<YourProxyHost>:<Port>'
```

## Verify the setup

Run the following command to confirm that the CLI is configured correctly and can reach your environment:

* Windows: `.\collibra info`
* Linux or Mac: `./collibra info`

If the setup is successful, the CLI returns information about your Collibra environment.

## General usage

The CLI is organized into command groups based on the Collibra feature area. You run commands in the following format:

```bash
./collibra <command-group> <action> [flags]
```

Use the `--help` flag at any level to see the available commands and flags:

```bash
./collibra --help
./collibra <command-group> --help
./collibra <command-group> <action> --help
```

The following command groups are available:

* `ai-gov`: [Register and manage AI model versions](https://productresources.collibra.com/docs/collibra/latest/Content/AICommandCenter/co_aicc-cli-tool.htm) in Collibra.
* `data-contract`: [Create and manage data contracts](https://productresources.collibra.com/docs/collibra/latest/Content/DataProducts/ta_create-data-contract-api-cli.htm) and their manifest files.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.collibra.com/cli/cli.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.