Install Iron

Get up and running with a single command. Pre-built binaries are available for macOS, Linux and Windows.

It looks like you're running macOS. Run the following in your terminal to install Iron:
Terminal
$ curl --proto '=https' --tlsv1.2 -sSfL https://ironlang.dev/install.sh | sh

This downloads and runs install.sh, which installs the iron binary to ~/.iron/bin and configures your shell PATH. You may need to restart your terminal or run source "$HOME/.iron/env" to get started.

It looks like you're running Windows. Run the following in PowerShell to install Iron:
PowerShell
> irm https://ironlang.dev/install.ps1 | iex

This downloads and runs install.ps1, which installs iron.exe and ironc.exe to %USERPROFILE%\.iron\bin and adds it to your PATH. Compiling programs also needs the Visual Studio Build Tools (the "Desktop development with C++" workload); the C compiler itself is Iron's own pinned toolchain, downloaded on first use.

Could not detect your platform. On macOS or Linux, run the following in your terminal; on Windows, run irm https://ironlang.dev/install.ps1 | iex in PowerShell:
Terminal
$ curl --proto '=https' --tlsv1.2 -sSfL https://ironlang.dev/install.sh | sh

What the installer does

1
Downloads the latest release
Fetches the correct pre-built binary for your OS and architecture from GitHub releases.
2
Installs the binary
Places the iron executable in ~/.iron/bin and creates an env file at ~/.iron/env.
3
Configures your PATH
Updates your shell profile (.bashrc, .zshrc, or .bash_profile) to source ~/.iron/env on startup.

Other installation methods

Download a release

Pre-built binaries for macOS (arm64, x86_64), Linux (x86_64) and Windows (x86_64) are available on the releases page.

View releases

Build from source

Build the compiler yourself. Requires a C compiler and standard build tools.

Build instructions

Explore examples

Start with a small native program, then explore tools, network services, simulations, graphics, and games.

Try a native example