Common Problems

This page details common tt-installer issues and their solutions.

Software versions are empty or "null"

If you see an error like this:

There are several possible causes. Refer to the tt-installer output for one of these issues:

jq command not found

Please install jq using your distribution package manager.

GitHub API rate limit exceeded

Refer to Using a Personal Access Token.

GitHub API returned invalid JSON

This is likely a GitHub issue. Please check GitHub status.

no valid tag_name found in API response

If the error occurs only once, there is probably an issue with the repository release. Open an issue on the repository that caused the issue. If the error happens for all repositories, this is likely a GitHub issue.

unknown error (code <error_code>)

Please open an issue on this repository with a verbose debug log so we can troubleshoot.

Using a Personal Access Token

If you have been ratelimited by the GitHub API, you can either wait a few minutes or provide a GitHub token to the script to authenticate your request:

./install.sh --github-token="your_token_here"

To create a fine-grained PAT for your GitHub account, visit this page. The token requires no permissions beyond read access to public repositories. tt-installer uses the token only for fetching software versions.

If you're unsure how to use tt-installer with arguments, visit Getting Started.

Getting a verbose log

By running install.sh with the --verbose argument, you can get detailed output from the commands we run. If you open an issue, please submit a verbose log so we can get as much information as possible.

./install.sh --verbose"