Skip to main content

​
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. Select llm to let the installer set up the harness for you, or select no llm.
# Install iii
$curl -fsSL https://install.iii.dev/iii/main/install.sh | sh
# Open your browser to http://127.0.0.1:3113
# Create a project
$iii project init my-app && cd my-app
# Start your project
$
# Open your browser to http://127.0.0.1:3113
# You can also check out iii.dev/docs/quickstart to learn more about iii

​
Installer options

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

​
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:

​
Install a pre-release

Use --next for the latest next pre-release, or --rc for the latest release candidate:
To install one exact version, give the version as the last argument:

​
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:
A non-empty III_NON_INTERACTIVE does the same:

​
Control the install with environment variables

​
Next Steps

Quickstart

Follow the Quickstart and explore a live iii application.

Use iii

Learn how to use iii in production.