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

# Installation

> Install the Rye CLI and daemon on macOS or Linux.

Rye ships as two local binaries:

* `rye`: the user-facing CLI.
* `ryed`: the background daemon that owns proxy lifecycle, local storage, policy sync, and system proxy restoration.

## Install with the script

Install the latest stable release:

```bash theme={null}
curl -fsSL https://storage.googleapis.com/barn.rye.ai/install.sh | sh
```

The installer:

* Detects macOS or Linux and the local CPU architecture.
* Downloads release artifacts from `https://storage.googleapis.com/barn.rye.ai/releases`.
* Verifies each binary against the release manifest checksum.
* Installs `rye` and `ryed` into a `bin` directory.
* Installs shell completions for supported shells.
* Registers `ryed` with launchd on macOS or a systemd user service on Linux when available.
* Installs `claude` and `codex` app shims when those commands exist.

## Install location

By default, the installer uses:

* `$HOME/.local/bin` for non-root user installs.
* `/usr/local/bin` when you pass `--system` or run as root.

Use `--prefix` to choose a different prefix:

```bash theme={null}
curl -fsSL https://storage.googleapis.com/barn.rye.ai/install.sh | sh -s -- --prefix "$HOME/.rye"
```

Make sure the selected `bin` directory is on `PATH`.

## Installer options

```bash theme={null}
install.sh [stable|latest|VERSION] [--system] [--prefix PATH] [--no-persist-proxy] [--no-wrap-agents]
```

Use these options when piping the script through `sh`:

```bash theme={null}
curl -fsSL https://storage.googleapis.com/barn.rye.ai/install.sh | sh -s -- latest
curl -fsSL https://storage.googleapis.com/barn.rye.ai/install.sh | sh -s -- 0.7.2
curl -fsSL https://storage.googleapis.com/barn.rye.ai/install.sh | sh -s -- --no-wrap-agents
```

| Option               | Use it when                                                                                          |
| -------------------- | ---------------------------------------------------------------------------------------------------- |
| `stable`             | You want the default stable release.                                                                 |
| `latest`             | You want the newest published release.                                                               |
| `VERSION`            | You need a specific semver release.                                                                  |
| `--system`           | You want to install under `/usr/local`.                                                              |
| `--prefix PATH`      | You want a custom install prefix.                                                                    |
| `--no-persist-proxy` | You do not want the installer to copy existing proxy environment variables into shell startup files. |
| `--no-wrap-agents`   | You do not want the installer to set up `claude` and `codex` shims.                                  |

## Install with Homebrew

On systems using Homebrew:

```bash theme={null}
brew install ryeai/tap/rye
```

Start the daemon:

```bash theme={null}
brew services start rye
```

Then sign in and start Rye:

```bash theme={null}
rye auth login
rye up
```

## Update Rye

Use the Rye updater:

```bash theme={null}
rye upgrade
```

Pin a release:

```bash theme={null}
rye upgrade 0.7.2
```

If you installed with Homebrew, update through Homebrew:

```bash theme={null}
brew upgrade ryeai/tap/rye
```

## Verify installation

```bash theme={null}
rye version
rye daemon status
rye doctor
```

If `rye` is not found, restart your shell and confirm the install directory is on `PATH`.