Docs Menu

Installation

Get Ion running on your machine in seconds.

Prerequisites

Before installing Ion, ensure you have the following installed on your system:

RequirementDetails
C++ CompilerGCC, Clang, or MSVC. Must support at least C++11 (C++20 recommended).
CMakeVersion 3.20 or newer. Used for generating build systems.
libclang (Optional)Required only if you want to use the LSP go-to-definition or AST-based lint rules.

Linux & macOS (One-liner)

The fastest way to install Ion is via our bash installer screen. This will cleanly install the binary and update your path.

bash
curl -fsSL https://ion.cybergenii.com/install.sh | sh

Windows (PowerShell)

Windows users can install via PowerShell. Ensure you run this as your standard user, not Administrator, unless you want a system-wide installation.

powershell
irm https://ion.cybergenii.com/install.ps1 | iex

From Source

If you already have Rust and Cargo installed, you can build Ion directly from source.

bash
cargo install ion
# or manually from GitHub
git clone https://github.com/cybergenii/ion
cd ion
cargo install --path .

Environment Variables

The installer can be configured using environment variables:

  • ION_INSTALL_DIR - Set a custom installation directory (default: ~/.ion/bin).
  • ION_VERSION - Specify a specific version tag to install (e.g. v0.2.1).
  • ION_NO_MODIFY_PATH - Skip automatic modification of .bashrc / .zshrc.
  • ION_INSTALL_DEPS - Set to 0 or 1 to skip or force CMake/Compiler dependency checks during setup.
! NOTE

Make sure to restart your terminal or source ~/.bashrc after installation so your PATH resolves the newly installed ion binary.