Tidelift CLI troubleshooting

You may encounter issues or unexpected behavior running Tidelift CLI. Here are some things you can do to troubleshoot, but please reach out to support@tidelift.com with any questions.

1. Ensure that you are on the latest version of the Tidelift CLI. You can check the current version by visiting https://download.tidelift.com/cli/tidelift-cli.version and compare to the current installed version by running tidelift version. We regularly update the CLI with fixes and improvements. Information on upgrading is found at the bottom of the CLI installation doc.
   1. Skip update checks using TIDELIFT_SKIP_UPDATE_CHECK=1
2. Ensure that you can reach the Internet from your machine (either developer workstation or CI system). Running curl https://api.tidelift.com/subscriber/healthcheck should include OK in the response (Linux/Mac only)
   • To function properly, the Tidelift CLI requires the ability to access:
     • api.tidelift.com (for using the Tidelift API)
     • download.tidelift.com (for using tidelift selfupdate to install new versions)
3. Ensure that the Tidelift CLI can access the internet by running tidelift selftest --project test
4. Ensure that you’re using a correct API key and that the key has not been revoked. 
5. Ensure that your package manager build command is operational. The Tidelift CLI generates a lockfile for any detected manifest if the lockfile is not already present. If alignment fails with Error: Exit status 1, we may be unable to generate a lockfile, due to either a syntax issue with the manifest or an improperly configured build environment.

   To disable the creation of a lockfile, set the environment variable TIDELIFT_<package manager>_NO_RESOLVE to 1. This will only upload a raw manifest, and you will not get full insight into your dependencies. Valid values are:

   • TIDELIFT_GO_NO_RESOLVE=1 (do not resolve Go dependencies)
   • TIDELIFT_MAVEN_NO_RESOLVE=1 (do not resolve Java Maven dependencies)
   • TIDELIFT_GRADLE_NO_RESOLVE=1 (do not resolve Java Gradle dependencies)
   • TIDELIFT_NPM_NO_RESOLVE=1 (do not resolve JavaScript dependencies)
   • TIDELIFT_PYTHON_NO_RESOLVE=1 (do not resolve Python dependencies)

   You can also pre-create a lockfile manually that will be used when running the CLI. To create a lockfile by hand that can be uploaded, see How to generate lockfiles from manifests.

6. If your project has a maven wrapper committed to its source tree but the wrapper will not run, you can set the environment variable TIDELIFT_MAVEN_IGNORE_WRAPPER to 1.

Editor Integration Troubleshooting

You may have been sent to this page by one of our IDE plugins. Tidelift IDE plugins use the Tidelift CLI internally, and the troubleshooting steps above are relevant for those as well.