Install the Flux CLI

One command installs the flux binary on macOS, Linux, or Windows (arm64 and amd64).

One-command install

The fastest way to install on macOS or Linux:

$ curl -fsSL https://fluxbase.co/install | bash

What the script does

Detects your OS and CPU architecture, downloads the correct binary from the latest GitHub Release, and moves it to /usr/local/bin/flux (or ~/.local/bin/flux if /usr/local/bin is not writable).

macOS

Automatic (recommended)

$ curl -fsSL https://fluxbase.co/install | bash

Homebrew (coming soon)

$ brew install flux-run/tap/flux

Manual download

# Apple Silicon (M1/M2/M3/M4)
$ curl -fsSL https://github.com/flux-run/flux/releases/latest/download/flux-darwin-arm64 \
    -o /usr/local/bin/flux && chmod +x /usr/local/bin/flux

# Intel Mac
$ curl -fsSL https://github.com/flux-run/flux/releases/latest/download/flux-darwin-amd64 \
    -o /usr/local/bin/flux && chmod +x /usr/local/bin/flux

Linux

Automatic

$ curl -fsSL https://fluxbase.co/install | bash

Manual download

# x86_64 / amd64
$ curl -fsSL https://github.com/flux-run/flux/releases/latest/download/flux-linux-amd64 \
    -o /usr/local/bin/flux && chmod +x /usr/local/bin/flux

# ARM64 (Graviton, Raspberry Pi, etc.)
$ curl -fsSL https://github.com/flux-run/flux/releases/latest/download/flux-linux-arm64 \
    -o /usr/local/bin/flux && chmod +x /usr/local/bin/flux

Windows

Automatic (PowerShell)

PS> irm https://fluxbase.co/install.ps1 | iex

Direct download

Or download the binary for your architecture and add it to a directory in your PATH:

flux-windows-amd64.exe — Intel/AMD 64-bit
flux-windows-arm64.exe — ARM64 (Snapdragon, etc.)

Scoop (coming soon)

scoop bucket add flux-run https://github.com/flux-run/scoop
scoop install flux

Verify installation

$ flux --version
flux 1.0.0

Start building

Flux is self-hosted — no account or login required. Initialize a project and start the local server:

$ flux init my-backend && cd my-backend
$ flux dev

This starts the Flux server on localhost:4000 with hot-reloading enabled.

You're ready!

Head to the Quickstart to deploy your first function.

Supported platforms

OS	Architecture	Binary
macOS	arm64 (Apple Silicon)	`flux-darwin-arm64`
macOS	amd64 (Intel)	`flux-darwin-amd64`
Linux	arm64	`flux-linux-arm64`
Linux	amd64	`flux-linux-amd64`
Windows	arm64	`flux-windows-arm64.exe`
Windows	amd64	`flux-windows-amd64.exe`

Next: Quickstart →