Skip to main content

Installing the Tidelift CLI

Larry Copeland
  • Updated

 

The Tidelift Command Line Interface ( Tidelift CLI ) provides an alternate way to initiate scans of a project and check the alignment of a project with your organization's catalog of approved open-source packages.

Install instructions

Note: A Tidelift subscription account is needed to use Tidelift CLI.

1. Install the CLI tool into your user's binary directory (we suggest a ~/bin on Mac & Linux) using the curl command below for your OS.

  • Linux: curl https://download.tidelift.com/cli/tidelift -o ~/bin/tidelift
  • MacOS: curl https://download.tidelift.com/cli/tidelift_darwin -o ~/bin/tidelift
  • Windows: curl https://download.tidelift.com/cli/tidelift.exe -o tidelift.exe
 
2. Provide permissions to run the CLI tool (eg. on Mac & Linux: chmod +x ~/bin/tidelift) 
If ~/bin is in your path, you will be able to use Tidelift CLI by running tidelift. Otherwise, ~/bin/tidelift.
 3. Authenticate your user by running tidelift authenticate and pasting your user API key when prompted. You can create and view API keys for your user in the Tidelift web interface under Settings->API Keys.

Checking the Version

To check to see what version of the Tidelift CLI you are running, please run tidelift version.

If you have a pre-installation requirement to check the current version of Tidelift CLI, you can check the version at the following URL: https://download.tidelift.com/cli/tidelift-cli.version

A SHA256 checksum of the current release is available at the following URL: https://download.tidelift.com/cli/tidelift-cli.sha256

To verify that this release comes from Tidelift, you can download the signature for the checksums file at https://download.tidelift.com/cli/tidelift-cli.sha256.sig and you can verify this using our public key https://download.tidelift.com/cli/TideliftPubkey.pem and running openssl dgst -sha512 -verify TideliftPubkey.pem -signature tidelift-cli.sha256.sig tidelift-cli.sha256

 

Updating and removing

To update to the latest version of the CLI tool, you can run the command tidelift selfupdate

To uninstall Tidelift CLI, remove the downloaded binary from your computer (e.g. on Linux and MacOS, rm ~/bin/tidelift).

Viewing changelog

The Tidelift CLI changelog is published at https://download.tidelift.com/cli/CHANGELOG.md

Next: Create a project

Related articles