Collibra sites
Use this menu to easily navigate to Collibra sites, documentation, resource centers and community forums.
Collibra.com
Dashboard
Community
Developer Portal
Documentation
Marketplace
Product Resource Center
Support
University

Collibra CLI

hero image

Install the 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

  1. Download the CLI binary from GitHub 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.

  2. 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

  3. 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

  4. 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.

  5. 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.

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.

Windows CMD

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

Windows PowerShell

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

Mac and Linux

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

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:

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:

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

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

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

The following command groups are available: