Installation

Install the FOKS CLI on your platform.

Managed Installers

macOS

brew install foks

The Homebrew package is signed by the FOKS developers, allowing keychain access without repeated password prompts.

Debian / Ubuntu

curl -fsSL https://pkgs.foks.pub/install.sh | sh

This registers the FOKS apt repository. Subsequent updates use the normal package manager:

sudo apt-get install foks

Fedora

curl -fsSL https://pkgs.foks.pub/install.sh | sh

This registers the FOKS dnf repository. Subsequent updates:

sudo dnf install foks

Arch Linux

yay -Sy go-foks

Windows

winget install foks

Static Linux Binary

For systems without a supported package manager:

curl -fsSL https://pkgs.foks.pub/install-static.sh | sh

Static binaries do not auto-update.

Build from Source

Requires Go 1.23+ with CGO enabled (for SQLite).

go install github.com/foks-proj/go-foks/client/foks@latest
(cd $(dirname $(which foks)) && ln -s foks git-remote-foks)
foks ctl start

The symlink makes foks available as a Git remote helper under the name git-remote-foks.

Verify Installation

foks version

Next Steps

Once installed, start the agent and sign up.