# Installation

## Linux

### Via Cargo (recommended)

Requires Rust. If you don't have it yet:

```sh
curl https://sh.rustup.rs -sSf | sh
```

Then install `rdrop`:

```sh
cargo install ringdrop
```

After installation, make sure `~/.cargo/bin` is in your `PATH`:

```sh
export PATH="$HOME/.cargo/bin:$PATH"
```

Add that line to `~/.bashrc`, `~/.zshrc`, or equivalent to make it permanent.

---

## macOS

### Via install script (recommended)

Handles both first-time install and upgrades:

```sh
curl -fsSL https://raw.githubusercontent.com/rikettsie/ringdrop/main/install/install.sh | sh
```

Requires [Homebrew](https://brew.sh). If you don't have it:

```sh
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```

### Manually via Homebrew

```sh
brew tap rikettsie/tap
brew install rdrop        # first install
brew upgrade rdrop        # upgrade
```

---

## Windows

### Via install script (recommended)

Run in PowerShell. Handles both first-time install and upgrades:

```powershell
irm https://raw.githubusercontent.com/rikettsie/ringdrop/main/install/install.ps1 | iex
```

Requires [Scoop](https://scoop.sh). If you don't have it:

```powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
irm get.scoop.sh | iex
```

### Manually via Scoop

```powershell
scoop bucket add rikettsie https://github.com/rikettsie/scoop-bucket
scoop install rdrop       # first install
scoop update rdrop        # upgrade
```

---

## Verify the installation

```sh
rdrop --version
```
