Quickstart

1. Start the agent

FOKS uses a background agent (similar to ssh-agent) to hold keys in memory and perform background rekeying work. Start it once and it will persist across reboots via systemd, launchd, or the Windows Registry.

foks ctl start

Check that it’s running:

foks ctl status

foks signup

This walks you through an interactive signup. When prompted for a server, choose foks.app to use the managed hosting service. You’ll need an invite code — the current code is cczjho9r.

Contact max@ne43.com for a free or discounted plan coupon code.

3. Create an encrypted Git repository

foks git create myrepo

FOKS prints a URL like foks://foks.app/alice/myrepo. Use this as a Git remote.

4. Push to it

git init myproject
cd myproject
echo "# Hello FOKS" > README.md
git add . && git commit -m "initial commit"
git remote add origin foks://foks.app/alice/myrepo
git push origin main

The git-remote-foks helper (a symlink to the foks binary) handles the foks:// remote scheme transparently. Git invokes it automatically.

5. Clone on another machine

After provisioning the new device, cloning works exactly like a standard git clone:

git clone foks://foks.app/alice/myrepo

6. Store a secret

# Store a string
foks kv put /secrets/api-key "mysupersecretvalue"

# Store a file
foks kv put /secrets/config.json --file config.json

# Retrieve it
foks kv get /secrets/api-key

# Create a team
foks team create myteam

# Generate an invite code and share it with a teammate
foks team invite myteam

# Teammate accepts on their machine
foks team accept <invite-code>

# Store a secret readable by the whole team
foks kv put --team myteam /shared/db-password "secret"

Next Steps

CLI Reference

Full reference for all foks commands.

Core Concepts

Understand the security and key management model.

Team Management

Roles, invites, and federated teams.

Self-hosting

Run your own FOKS server.

Getting Started

Core Concepts

CLI Reference

Self-Hosting

1. Start the agent

3. Create an encrypted Git repository

4. Push to it

5. Clone on another machine

6. Store a secret

Next Steps

CLI Reference

Core Concepts

Team Management

Self-hosting

​1. Start the agent

​2. Sign up

​3. Create an encrypted Git repository

​4. Push to it

​5. Clone on another machine

​6. Store a secret

​7. Share with a team

​Next Steps

CLI Reference

Core Concepts

Team Management

Self-hosting

1. Start the agent

2. Sign up

3. Create an encrypted Git repository

4. Push to it

5. Clone on another machine

6. Store a secret

7. Share with a team

Next Steps