Install Iron

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

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. Iron currently supports macOS and Linux.
You can install Iron using WSL (Windows Subsystem for Linux). Open a WSL terminal and run the command below. Native Windows support is planned.
WSL Terminal
$ curl --proto '=https' --tlsv1.2 -sSfL https://ironlang.dev/install.sh | sh

See the GitHub repository for updates on native Windows support.

Could not detect your platform. Iron supports macOS and Linux. If you're on a supported OS, run the following in your terminal:
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) and Linux (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

Start with raylib

Iron ships with a full raylib 6.0 binding in the stdlib. Build real 2D/3D games in pure Iron — 183 requirements, 14 categories.

Open the raylib docs