# Installation (/docs/v0.1/installation)



koshi ships prebuilt binaries for Linux, macOS, and Windows on x86-64 and
ARM64. Pick one method below.

## macOS [#macos]

With Homebrew:

```bash
brew install gohyuhan/koshi/koshi
```

Homebrew adds the koshi tap during installation. Upgrade koshi along with your
other outdated packages:

```bash
brew update
brew upgrade
```

Or upgrade only koshi:

```bash
brew upgrade koshi
```

With the release script:

```bash
curl --proto "=https" --tlsv1.2 -sSfL \
  https://github.com/gohyuhan/koshi/releases/latest/download/install.sh | bash
```

## Linux [#linux]

```bash
curl --proto "=https" --tlsv1.2 -sSfL \
  https://github.com/gohyuhan/koshi/releases/latest/download/install.sh | bash
```

## Windows [#windows]

With PowerShell:

```powershell
powershell -c "irm https://github.com/gohyuhan/koshi/releases/latest/download/install.ps1 | iex"
```

With Scoop:

```powershell
scoop bucket add koshi https://github.com/gohyuhan/scoop-koshi
scoop install koshi/koshi
```

Upgrade after refreshing Scoop:

```powershell
scoop update
scoop update koshi
```

## From source [#from-source]

Building needs Rust 1.96.

```bash
git clone https://github.com/gohyuhan/koshi.git
cd koshi
cargo build --release
./target/release/koshi
```

## Updating in place [#updating-in-place]

koshi checks for a newer release at startup and can install it itself:

```bash
koshi update
```

<Callout>
  Removing koshi later takes more than deleting the binary — config, logs, cache,
  and runtime files live outside the install directory. See
  [Uninstall](/docs/v0.1/uninstall).
</Callout>