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

# Install

> Install the iii engine and set up your agentic development environment.

## Start a project

The recipe below installs the engine and starts a project. Once started you can explore the project
via [http://127.0.0.1:3113](http://127.0.0.1:3113).

Select **llm** to let the installer set up the harness for you, or select **no llm**.

llm

no llm

\# Install iii

\$
curl -fsSL [https://install.iii.dev/iii/main/install.sh](https://install.iii.dev/iii/main/install.sh) | sh

\# The installer prompts you to set up your first iii project. Press Enter.

\# Open your browser to [http://127.0.0.1:3113](http://127.0.0.1:3113)

\# The installer prompts you to set up your first iii project. Press Ctrl+C.

\# Create a project

\$
iii project init my-app && cd my-app

\# Start your project

\$

iii compose --up

\# Open your browser to [http://127.0.0.1:3113](http://127.0.0.1:3113)

\# You can also check out [iii.dev/docs/quickstart](/docs/0-24-0/quickstart.md) to learn more about iii

## Installer options

The installer takes its options after `sh -s --`. To see them all:

```bash theme={"theme":{"light":"catppuccin-latte","dark":"dark-plus"}}
curl -fsSL https://install.iii.dev/iii/main/install.sh | sh -s -- --help
```

### Run the setup against an installed engine

When iii is already on the machine, in `BIN_DIR` or on your `PATH`, the installer upgrades it and
does not prompt for the setup.

`--skip-bin-download` skips the download and the install, and runs the setup against the iii that is
on the machine already. Use it to repeat the setup, or when you build the engine yourself:

```bash theme={"theme":{"light":"catppuccin-latte","dark":"dark-plus"}}
curl -fsSL https://install.iii.dev/iii/main/install.sh | sh -s -- --skip-bin-download
```

### Install a pre-release

Use `--next` for the latest `next` pre-release, or `--rc` for the latest release candidate:

```bash theme={"theme":{"light":"catppuccin-latte","dark":"dark-plus"}}
curl -fsSL https://install.iii.dev/iii/main/install.sh | sh -s -- --rc
```

To install one exact version, give the version as the last argument:

```bash theme={"theme":{"light":"catppuccin-latte","dark":"dark-plus"}}
curl -fsSL https://install.iii.dev/iii/main/install.sh | sh -s -- 0.23.1
```

### Install without a prompt

The installer does not prompt when no terminal is attached. A `docker build` step, a CI job, and a
plain `curl ... | sh` in a script are already non-interactive, and they do the install and then
print the setup command.

`--non-interactive` makes that behavior explicit, and keeps it when a terminal is attached: the
installer does the install, does not run the setup, and prints the setup command. Use it when a terminal is attached but you want the install
only, for example `docker run -it`, `docker compose run`, or a wrapper that gives the command a
terminal:

```bash theme={"theme":{"light":"catppuccin-latte","dark":"dark-plus"}}
curl -fsSL https://install.iii.dev/iii/main/install.sh | sh -s -- --non-interactive
```

A non-empty `III_NON_INTERACTIVE` does the same:

```bash theme={"theme":{"light":"catppuccin-latte","dark":"dark-plus"}}
curl -fsSL https://install.iii.dev/iii/main/install.sh | III_NON_INTERACTIVE=1 sh
```

### Control the install with environment variables

| Variable | Effect |
| - | - |
| `VERSION` | Engine version to install, for example `0.23.1`. |
| `BIN_DIR` | Directory for the engine binary. Defaults to `$PREFIX/bin`, or `$HOME/.local/bin`. |
| `PREFIX` | Install prefix. Defaults to `$HOME/.local`. |
| `TARGET` | Target triple to install, for example `aarch64-unknown-linux-gnu`. |
| `III_USE_GLIBC` | Any non-empty value selects the glibc build on Linux x86\_64. The default is musl. |
| `GITHUB_TOKEN` | Authenticates the GitHub API calls and raises the rate limit from 60/hr to 5000/hr. |
| `III_NON_INTERACTIVE` | Any non-empty value does the same as `--non-interactive`. |

## Next Steps

> **[Quickstart](/docs/0-24-0/quickstart.md)**
>
> Follow the Quickstart and explore a live iii application.

> **[Use iii](./using-iii)**
>
> Learn how to use iii in production.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.