> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ironrun.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# ironrun Installation: Linux, macOS, Windows, and Go

> Install ironrun using the verified curl installer, Go toolchain, or npm. Supports Linux, macOS (Intel and Apple Silicon), and Windows x86_64.

ironrun ships as a single self-contained binary with no runtime dependencies. You can install it three ways: the curl installer (recommended for Linux and macOS), `go install` (any platform with a Go toolchain), or the npm launcher (any platform with Node.js). Windows users can also download a pre-built zip directly from the GitHub releases page.

## Install

<CodeGroup>
  ```bash curl (Linux / macOS) theme={null}
  curl -fsSL https://ironrun.dev/install.sh -o /tmp/ironrun-install.sh
  bash /tmp/ironrun-install.sh
  ```

  ```bash go install theme={null}
  go install github.com/generalized-labs/ironrun/cmd/ironrun@latest
  ```

  ```bash npm / npx theme={null}
  npx @generalized-labs/ironrun@latest
  ```
</CodeGroup>

<Note>
  The curl installer performs mandatory checksum verification before writing anything to disk. The script is downloaded separately from the binary so you can inspect it before running it. It will exit non-zero and refuse to install if the checksum does not match the published release manifest.
</Note>

## Windows (beta)

Windows amd64 support is currently in beta. Download the pre-built archive from the [latest GitHub release](https://github.com/generalized-labs/ironrun/releases/latest), extract it, and add `ironrun.exe` to a directory on your `PATH`.

1. Download `ironrun_Windows_x86_64.zip` from the [latest release](https://github.com/generalized-labs/ironrun/releases/latest).
2. Extract the archive.
3. Move `ironrun.exe` to a directory that is already on your `PATH` (for example `C:\Users\you\bin`), or add the extraction directory to your `PATH` in System Settings → Environment Variables.

## Verify the installation

After installing by any method, confirm the binary is reachable and print its version:

```bash theme={null}
ironrun version
# ironrun v0.4.0
```

A source build (via `go install` from a local clone without ldflags set) prints `ironrun vdev` instead of a version number — that is expected.

## Prerequisites

| Install method | Requirement                                                  |
| -------------- | ------------------------------------------------------------ |
| curl installer | Linux or macOS; `bash`, `curl`, and standard POSIX utilities |
| `go install`   | Go 1.21 or later                                             |
| `npx`          | Node.js 20 or later                                          |
| Windows zip    | Windows x86\_64 (amd64); no runtime required                 |

<Note>
  The npm package (`@generalized-labs/ironrun`) is a thin native launcher — it downloads and verifies the correct platform binary on first run rather than bundling a Node.js wrapper. The Go security boundary is preserved; Node.js is only used to bootstrap the binary. Node.js 20 or later is required for the immutable artifact verification the launcher performs.
</Note>

## Updating

Re-run the same install command you used originally. The curl installer and `go install` always fetch the latest tagged release. For `npx`, pass `@latest` explicitly to bypass any cached version:

```bash theme={null}
npx @generalized-labs/ironrun@latest version
```

## Next steps

Once ironrun is installed, head to the [Quickstart](/quickstart) to run `ironrun setup` in your project directory and make your first sealed command execution.