Install the Floe CLI

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.

macOS
Windows (winget)
Windows (scoop)

brew install --cask jannskiee/tap/floe

Update: brew upgrade floeFirst 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).

winget install jannskiee.floe

Update: winget upgrade jannskiee.floeWinget 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).

scoop bucket add jannskiee https://github.com/jannskiee/scoop-bucket
scoop install floe

Update: scoop update floeScoop can be installed with irm get.scoop.sh | iex.

One-line installer

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

macOS / Linux
Windows (PowerShell)

curl -fsSL https://floe.one/install.sh | sh

To install a specific version:

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).

irm https://floe.one/install.ps1 | iex

To install a specific version:

$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.

Go install

If you have Go 1.25 or later installed:

go install github.com/jannskiee/floe/cli/cmd/floe@latest

Verify the install

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, each release includes a checksums.txt file. To verify:

# 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:

floe update

See Updating floe for details.

Build from source

Requires Go 1.25 or later.

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).

Getting Started

Web App

CLI

Self-Hosting

How It Works

Reference

Install the Floe CLI

Package managers

One-line installer

Go install

Verify the install

Verify the checksum (manual download)

Update

Build from source

​Package managers

​One-line installer

​Go install

​Verify the install

​Verify the checksum (manual download)

​Update

​Build from source

Package managers

One-line installer

Go install

Verify the install

Verify the checksum (manual download)

Update

Build from source