Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.foks.pub/llms.txt

Use this file to discover all available pages before exploring further.

​
Managed Installers

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

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