Install

The kedge CLI talks to a hub from your laptop. It’s a single Go binary; pick whichever install method fits your workflow.

Prerequisites

• kubectl — install guide
• A hub URL — either the hosted hub at https://console.faros.sh or one you deploy yourself

Install via krew (recommended)

krew is the kubectl plugin manager. Once you’ve installed it, add the Faros plugin index and install kedge:

kubectl krew index add faros https://github.com/faroshq/krew-index.git
kubectl krew install faros/kedge

Now kubectl kedge is available everywhere:

kubectl kedge --help

To upgrade later:

kubectl krew upgrade

Install a release binary

Download a prebuilt binary from the releases page and put it in your $PATH.

# macOS / Linux example — adjust version and arch
curl -L https://github.com/faroshq/kedge/releases/latest/download/kedge-darwin-arm64 \
  -o /usr/local/bin/kedge
chmod +x /usr/local/bin/kedge

Both kedge ... and kubectl kedge ... work — kubectl auto-discovers any kubectl-* plugin on your $PATH. The docs use kubectl kedge everywhere; if you prefer the standalone binary, drop the kubectl prefix.

Install from source

go install github.com/faroshq/kedge/cmd/kedge@latest

This requires Go 1.25+ and puts the binary in $GOBIN (usually ~/go/bin).

Verify

kubectl kedge version

You should see something like:

kedge v0.x.x  (go1.25.x  darwin/arm64)

Next: log in

Head to the Quickstart to register your first edge.