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

# Install the Floe CLI

> Install the floe CLI in one command on macOS, Windows, or Linux to send and receive files peer-to-peer from the terminal without an account.

The `floe` CLI is a single self-contained binary with no runtime dependencies.

## Package managers

The fastest way to install floe. Package manager installs also get updates via the
standard upgrade command for that tool.

<Tabs>
  <Tab title="macOS">
    ```bash theme={null}
    brew install --cask jannskiee/tap/floe
    ```

    Update: `brew upgrade floe`

    First run: if macOS blocks the binary (Gatekeeper), right-click the `floe` binary in Finder
    and choose Open, or run `xattr -dr com.apple.quarantine $(which floe)`.
  </Tab>

  <Tab title="Windows (winget)">
    ```powershell theme={null}
    winget install jannskiee.floe
    ```

    Update: `winget upgrade jannskiee.floe`

    Winget is built into Windows 10/11. The package is available after each release once
    Microsoft's automated PR review completes (usually a few hours after the tag).
  </Tab>

  <Tab title="Windows (scoop)">
    ```powershell theme={null}
    scoop bucket add jannskiee https://github.com/jannskiee/scoop-bucket
    scoop install floe
    ```

    Update: `scoop update floe`

    [Scoop](https://scoop.sh) can be installed with `irm get.scoop.sh | iex`.
  </Tab>
</Tabs>

## One-line installer

Works on macOS, Linux, and Windows without a package manager. Re-running the script
upgrades an existing install in place.

<Tabs>
  <Tab title="macOS / Linux">
    ```bash theme={null}
    curl -fsSL https://floe.one/install.sh | sh
    ```

    To install a specific version:

    ```bash theme={null}
    curl -fsSL https://floe.one/install.sh | FLOE_VERSION=v1.2.0 sh
    ```

    The script detects your OS and architecture, downloads the correct archive, verifies the
    SHA-256 checksum, and installs `floe` to `/usr/local/bin` (or `~/.local/bin` when
    `/usr/local/bin` is not writable and `sudo` is unavailable).
  </Tab>

  <Tab title="Windows (PowerShell)">
    ```powershell theme={null}
    irm https://floe.one/install.ps1 | iex
    ```

    To install a specific version:

    ```powershell theme={null}
    $env:FLOE_VERSION = "v1.2.0"; irm https://floe.one/install.ps1 | iex
    ```

    The script downloads the correct `.zip` for your architecture, verifies the SHA-256 checksum,
    extracts to `%LOCALAPPDATA%\Programs\floe`, and adds that directory to your user `PATH`.
    Open a new terminal after running it.
  </Tab>
</Tabs>

## Go install

If you have Go 1.25 or later installed:

```bash theme={null}
go install github.com/jannskiee/floe/cli/cmd/floe@latest
```

## Verify the install

```bash theme={null}
floe version
```

Expected output:

```
floe 1.x.x
Docs: https://www.floe.one/docs
```

## Verify the checksum (manual download)

If you downloaded an archive directly from the [GitHub Releases page](https://github.com/jannskiee/floe/releases),
each release includes a `checksums.txt` file. To verify:

```bash theme={null}
# Download checksums
curl -LO "https://github.com/jannskiee/floe/releases/download/vX.Y.Z/checksums.txt"

# Verify (macOS)
shasum -a 256 --check --ignore-missing checksums.txt

# Verify (Linux)
sha256sum --check --ignore-missing checksums.txt
```

## Update

For package manager installs, use the standard upgrade command (`brew upgrade floe`,
`winget upgrade jannskiee.floe`, `scoop update floe`).

For script or manual installs, run:

```bash theme={null}
floe update
```

See [Updating floe](/docs/cli/update) for details.

## Build from source

Requires Go 1.25 or later.

```bash theme={null}
git clone https://github.com/jannskiee/floe.git
cd floe/cli
go build ./cmd/floe
```

Move the resulting `floe` binary to a directory on your `PATH` (e.g. `/usr/local/bin` on
macOS and Linux).