Installation

Install the Ion CLI binary on macOS, Linux, or Windows. The entire tool is under 15 MB.

System requirements

macOS 12 or later, Linux x64 or arm64, Windows 10 or later
512 MB of free memory
25 MB of disk space
No Node.js, Python, or other runtimes required

Install with npm

The npm package wraps the prebuilt binary and adds it to your PATH.

terminal

npm install -g ion-cli

Install with Homebrew

On macOS or Linux with Homebrew:

terminal

brew install ion-cli

Install with curl

The installer downloads the correct binary for your platform and puts it in ~/.ion/bin.

terminal

curl -fsSL https://ion.sh/install | sh

Install manually

Download the binary from the releases page, extract it, and move it into a directory on your PATH.

terminal

# example for Linux x64
curl -L -o ion.tar.gz https://github.com/ion-cli/ion/releases/download/v1.4.2/ion-linux-x64.tar.gz
tar -xzf ion.tar.gz
sudo mv ion /usr/local/bin/

Verify the install

Check the installed version:

terminal

ion --version

The output should be:

terminal output

ion 1.4.2

Uninstall

Remove Ion with the method that matches your installation.

terminal

# npm
npm uninstall -g ion-cli

# Homebrew
brew uninstall ion-cli

# manual
sudo rm /usr/local/bin/ion