Installation

Managed Installers

brew install foks

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

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

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

This registers the FOKS dnf repository. Subsequent updates:

sudo dnf install foks

yay -Sy go-foks

winget install foks

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.

Linux: YubiKey Setup

YubiKey support requires the PCSC lite daemon and development library:

sudo apt-get install libpcsclite-dev pcscd        # Debian/Ubuntu
sudo dnf install pcsc-lite-devel pcsc-lite         # Fedora

If your distribution restricts access to pcscd for non-root users, add a polkit rule:

cat <<EOF > /etc/polkit-1/rules.d/90-pcscd.rules
polkit.addRule(function(action, subject) {
    if (action.id == "org.debian.pcsc-lite.access_pcsc" &&
        subject.isInGroup("pcscd")) {
        return polkit.Result.YES;
    }
});
EOF

sudo groupadd pcscd
sudo usermod -aG pcscd $USER
sudo systemctl daemon-reload
sudo systemctl restart polkit
sudo systemctl restart pcscd

Log out and back in for the group change to take effect.

Verify Installation

foks version

Next Steps

Once installed, start the agent and sign up.

Getting Started

Core Concepts

CLI Reference

Self-Hosting

Installation

Managed Installers

Build from Source

Linux: YubiKey Setup

Verify Installation

Next Steps

​Managed Installers

​Build from Source

​Linux: YubiKey Setup

​Verify Installation

​Next Steps

Managed Installers

Build from Source

Linux: YubiKey Setup

Verify Installation

Next Steps