Skip to main content

​
System Requirements

The Tenderly CLI is a single binary with no additional dependencies. It works on:
  • macOS (Intel and Apple Silicon)
  • Linux (x86_64)
  • Windows (x86_64)

​
Installation Methods

The easiest way to install on macOS is via Homebrew:
brew tap tenderly/tenderly
brew install tenderly
Homebrew makes it easy to keep the CLI up to date with brew upgrade tenderly

​
Using Installation Script

Alternatively, you can install using our installation script:
curl https://raw.githubusercontent.com/Tenderly/tenderly-cli/master/scripts/install-macos.sh | sh
The script will:
  • Download the latest version for your architecture
  • Install the binary to /usr/local/bin/tenderly
  • Make the binary executable
You may need to grant terminal permissions in System Preferences for the installation to complete.

​
Verify Installation

After installation, verify that the CLI is working correctly: 
tenderly version
You should see output similar to: 
Current CLI version: v2.0.0

To report a bug or give feedback send us an email at [email protected]

​
Updating the CLI

​
Check Current Version

To check which version you’re currently running: 
tenderly version

​
Update via Homebrew (macOS)

If you installed via Homebrew, update with: 
brew upgrade tenderly

​
Update via Installation Script

For installations via the curl script, simply run the installation command again: 
curl https://raw.githubusercontent.com/Tenderly/tenderly-cli/master/scripts/install-macos.sh | sh
The script will replace your existing installation with the latest version.

​
Update on Windows

For Windows installations:
  1. Download the latest version from the releases page
  2. Replace your existing tenderly.exe file with the new one
  3. Verify the update with tenderly version

​
Check for Updates

The CLI can automatically check for updates: 
tenderly update-check
This command will:
  • Check if a newer version is available
  • Provide update instructions for your platform
  • Show changelog information
The CLI automatically checks for updates periodically and will notify you if a new version is available. Keep your CLI up to date to get the latest features and bug fixes.

​
Troubleshooting

​
Command Not Found

If you get a “command not found” error after installation:
1

Check PATH

Verify that the installation directory is in your PATH:
echo $PATH
Look for /usr/local/bin (macOS/Linux) or your Windows installation directory.
2

Restart Terminal

Close and reopen your terminal or IDE to reload environment variables.
3

Verify Binary Location

Check if the binary exists:
# macOS/Linux
ls -la /usr/local/bin/tenderly

# Windows (PowerShell)
Get-Command tenderly
4

Manual PATH Update

If needed, manually add the directory to your PATH:
# Bash (add to ~/.bashrc or ~/.bash_profile)
export PATH="$PATH:/usr/local/bin"

# Zsh (add to ~/.zshrc)
export PATH="$PATH:/usr/local/bin"

​
Permission Denied (macOS/Linux)

If you get a permission denied error: 
sudo chmod +x /usr/local/bin/tenderly

​
Installation Script Fails

If the installation script fails:
  1. Try running with sudo (Linux only)
  2. Manually download the binary from the releases page
  3. Move it to /usr/local/bin and make it executable: 
    chmod +x tenderly
sudo mv tenderly /usr/local/bin/

​
Antivirus Warnings (Windows)

Some antivirus software may flag the Tenderly CLI. This is a false positive. You can:
  1. Add an exception for tenderly.exe in your antivirus settings
  2. Download from the official GitHub releases page
  3. Verify the binary’s checksum against the published values

​
Uninstalling

​
macOS (Homebrew)

brew uninstall tenderly
brew untap tenderly/tenderly

​
macOS/Linux (Script Installation)

sudo rm /usr/local/bin/tenderly
Optionally remove configuration files: 
rm -rf ~/.tenderly

​
Windows

  1. Delete the tenderly.exe file from your PATH directory
  2. Remove the directory from your PATH environment variable (if you created a custom directory)
  3. Optionally delete the configuration directory (typically in %USERPROFILE%\.tenderly)

​
Next Steps

Now that you have the CLI installed, you’re ready to:

Quickstart Guide

Follow our quickstart to push your first contract

Authentication

Learn about login methods and authentication

Build docs developers (and LLMs) love

Get started for freeTalk to us