> How to install Jitzu on your system

# Installation

Jitzu is distributed as a single standalone binary — `jz` — that serves as both the script interpreter and the interactive shell. Download the self-contained build for your platform — it bundles the .NET runtime, so it works on any machine with no prerequisites.

_See [Installation](/docs/getting-started/installation) for platform downloads._

## Package Managers

### Windows (Scoop)

```bash
scoop bucket add jitzu https://github.com/jitzulang/jitzu
scoop install jz
```

## Self-Contained Binary

The self-contained binary bundles the .NET runtime, so it works on any machine with no
prerequisites. This is the easiest way to get started without a package manager.

### Windows

Download `jitzu-win-x64.zip` from the [latest GitHub release](https://github.com/jitzulang/jitzu/releases/latest) and extract it. Add the extracted directory to your PATH, or move the binary to a directory already on your PATH.

```bash
# PowerShell
Expand-Archive jitzu-win-x64.zip -DestinationPath C:\\tools\\jitzu
$env:PATH += ";C:\\tools\\jitzu"

# Or move to a directory already on PATH
Move-Item jz.exe C:\\Windows\\
```

### macOS

Download `jitzu-osx-arm64.zip` (Apple Silicon) or `jitzu-osx-x64.zip` (Intel) from the [latest release](https://github.com/jitzulang/jitzu/releases/latest).

```bash
unzip jitzu-osx-arm64.zip
sudo mv jz /usr/local/bin/
chmod +x /usr/local/bin/jz
```

### Linux

Download `jitzu-linux-x64.zip` from the [latest release](https://github.com/jitzulang/jitzu/releases/latest).

```bash
unzip jitzu-linux-x64.zip
sudo mv jz /usr/local/bin/
chmod +x /usr/local/bin/jz
```

## Self-Update

Jitzu can update itself:

```bash
jz upgrade
```

## Build from Source

Jitzu requires the [.NET 10 SDK](https://dotnet.microsoft.com/download/dotnet/10.0) to build from source.

```bash
git clone https://github.com/jitzulang/jitzu.git
cd jitzu
dotnet build
dotnet run --project Jitzu.Shell -- --help
dotnet run --project Jitzu.Shell
```

## Verify Installation

Check the interpreter is on your PATH:

```bash
jz --version
# jz v0.2.0
```

Then launch the shell:

```shell
jz v0.2.0

• runtime    : 10.0.0
• config     : ~/.jitzu/config.jz
• platform   : Unix

Type \`help\` to get started.

> 1 + 1
2
```