Windows Installation
# Via winget package manager
> winget install foks
macOS Installation
Automated install for macOS uses homebrew. Though it's possible to build FOKS from a source formula, we instead use the prebuilt Cask distribution method. As such, you'll get a binary signed by the FOKS developers (NE43 INC (L2W77ZPF94)). A signed binary with a known author allows for password-free access to the foks items in the macOS keychain. Without it, you'd have to enter multiple administrator passwords on every upgrade.
Debian Installation
# For first time installation... $ curl -fsSL https://pkgs.foks.pub/install.sh | sh # For subsequent installs after apt sources are in place: $ apt-get install foks
Ubuntu Installation
# For first time installation... $ curl -fsSL https://pkgs.foks.pub/install.sh | sh # For subsequent installs after apt sources are in place: $ apt-get install foks
Fedora Linux Installation
# For first time installation... $ curl -fsSL https://pkgs.foks.pub/install.sh | sh # For subsequent installs after apt sources are in place: $ dnf install foks
Arch Linux Installation
# Works via AUR
$ yay -Sy go-foks
Static Linux Binary
# Will not auto-update...
$ curl -fsSL https://pkgs.foks.pub/install-static.sh | sh
Build from Source
To build FOKS from source, you will need a relatively-modern Go installation (1.23 or later). CGO is required to build 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
Server
BYO VM (via cloud-provider) or bare-metal server. Requires docker-compose.
$ /usr/bin/env bash <(curl -fsSL https://pkgs.foks.pub/server-install.sh)
Or you can build the above from source:
$ go install github.com/foks-proj/go-foks/server/foks-tool@latest
$ foks-tool standup --interactive
$ docker-compose up -d