Installation

Ion provides pre-built binaries for macOS and Linux on both x86_64 and ARM architectures.

Quick install

The fastest way to install Ion is with the install script:

curl -fsSL https://raw.githubusercontent.com/Roger-luo/Ion/main/install.sh | sh

This detects your platform and downloads the appropriate binary.

From GitHub Releases

Download the latest release directly from GitHub Releases. Binaries follow the naming convention:

ion-{version}-{target}.tar.gz

Available targets:

TargetPlatform
aarch64-apple-darwinmacOS (Apple Silicon)
x86_64-apple-darwinmacOS (Intel)
aarch64-unknown-linux-gnuLinux (ARM)
x86_64-unknown-linux-gnuLinux (x86)

From source

If you have Rust installed, you can build from source:

cargo install --git https://github.com/Roger-luo/Ion.git

Verify installation

After installing, verify that Ion is available:

ion --version

Self-update

Ion can update itself:

ion self update    # Update to the latest version
ion self check     # Check if an update is available
ion self info      # Show version and build info