---
title: "Install · Alran Code Docs"
url: https://alran.dev/en/docs/install
locale: en
updated: 2026-11-16
---

[Docs](https://alran.dev/en/docs)Get started

# Install

One line on macOS, Linux and WSL. Or npm, anywhere Node.js runs.

On this page

[How do I install Alran Code?](#installer) [With npm](#npm) [Windows](#windows) [Update](#update) [Uninstall](#uninstall) [Build from source](#source) [Common questions](#faq)

## How do I install Alran Code? {#installer}

```bash
curl -fsSL https://alran.dev/install.sh | bash
```

The script needs nothing but `curl` (or `wget`) and `tar`. It:

1. Checks your system: macOS or Linux on x64 or arm64. WSL counts as Linux.
2. Uses your Node.js if it is a supported version (22.19 or newer on 22, 24.2 or newer on 24, 25 or 26). If not, it downloads Node.js 24 from nodejs.org, checks its SHA-256 and keeps it inside the install folder. Your system Node.js stays untouched.
3. Installs the alran package into ~/.alran-code and puts the launcher at ~/.alran-code/bin/alran.
4. Adds that folder to your PATH in your shell's startup file, marked with Alran Code CLI.

Open a new terminal afterwards, then run `alran --version`.

| Variable | What it does | Default |
| `ALRAN_INSTALL_DIR` | Where Alran Code is installed | `~/.alran-code` |
| `ALRAN_VERSION` | The version to install | `latest` |
| `ALRAN_NO_MODIFY_PATH` | `1` leaves your shell files alone | not set |

```bash
curl -fsSL https://alran.dev/install.sh | ALRAN_VERSION=0.6.9 bash
```

Want to read it first? Download, read, then run: `curl -fsSL https://alran.dev/install.sh -o install.sh`, then `less install.sh` and `bash install.sh`.

## With npm {#npm}

Node.js 22.19 or newer (22.x), 24.2 or newer (24.x), 25 or 26. Node 24.0 and 24.1 are not supported.

```bash
npm install -g alran
alran --version
```

pnpm, yarn and bun work the same way: `pnpm add -g alran`, `yarn global add alran`, `bun add -g alran`. Keep optional dependencies enabled and allow the native SQLite install script of `better-sqlite3` (npm does by default). Without a prebuilt binary for your Node version, native dependencies need Python and C/C++ build tools.

## Windows {#windows}

Run the installer inside WSL, or install with npm in PowerShell: `npm install -g alran`.

## Update {#update}

| Installed with | Update |
| npm, pnpm, yarn or bun | `alran update` |
| The installer | Run the install command again. It replaces the version in place. |

Alran Code checks for updates once a week and shows a hint. `ALRAN_NO_UPDATE_CHECK=1` turns the hint off.

## Uninstall {#uninstall}

Close running sessions first, including editor integrations.

```bash
# installed with the script
rm -rf -- "$HOME/.alran-code"
# then delete the "# Alran Code CLI" line and the
# PATH line after it from your shell startup file

# installed with npm
npm uninstall -g alran
```

Your sign-in, settings and sessions live separately in `~/.alran` and stay in place. Delete that folder only if you want them gone too.

## Build from source {#source}

You need Git, Node.js (as above) and pnpm 9.12.0.

```bash
git clone https://github.com/Alran-AI/code.git
cd code
corepack enable
pnpm install --frozen-lockfile
pnpm build
pnpm alran --help
```

To use a source build in another project, run the built entry point by its absolute path: `node /absolute/path/to/code/dist/cli.js`.

## Common questions {#faq}

How do I install Alran Code on macOS?

Run curl -fsSL https://alran.dev/install.sh | bash in your terminal. The script checks that you are on macOS or Linux on x64 or arm64, installs the alran package into ~/.alran-code, puts the launcher at ~/.alran-code/bin/alran and adds that folder to the PATH in the startup file of your shell. If you prefer npm, npm install -g alran works everywhere Node.js runs.

Which Node.js versions does Alran Code support?

Node.js 22.19 or newer on 22.x, 24.2 or newer on 24.x, and 25 or 26. Node 24.0 and 24.1 are not supported. The installer uses your own Node.js when the version fits and otherwise downloads Node.js 24 into the install folder, without touching your system Node.js.

How do I uninstall Alran Code without losing my sessions?

Close your running sessions first, then delete the ~/.alran-code folder (or run npm uninstall -g alran) and remove the line marked # Alran Code CLI together with the PATH line after it from your shell startup file. Your sign-in, settings and sessions live separately in ~/.alran and stay in place, so delete that folder only if you want them gone too.

[NextQuickstart](https://alran.dev/en/docs/quickstart)
