People and accounts
Invite people, manage server admins, sessions and tokens, and read who did what.
Each instance has its own accounts, and only a server admin brings people in: there is no sign-up page. Everything here needs a server admin, from the web app's admin pages or from the CLI.
Invite someone
fontego admin users invite ana@example.org --name "Ana"Ana gets a mail with a one-time link to choose her password (at least 15 characters). Without SMTP, the message waits
in fontego admin mail outbox for you to pass the link on. fontego admin users resend sends a new link and the
earlier one stops working.
Links carry their secret after #, so it never reaches a server log, and the server keeps only a hash of it.
To give her access to a workspace: fontego members set notes ana@example.org editor
(Workspaces).
Passwords
- A person who forgot theirs asks for a link from the web app, or with
fontego password-reset EMAIL. The answer is the same whether the address has an account or not. fontego admin users reset-password EMAILsends someone a link.- When nobody can sign in, or there is no mail,
fontego-server admin-link EMAILon the server's machine prints a link.
Server admins
fontego admin users grant-admin EMAIL and revoke-admin EMAIL. The last server admin can't be removed.
Leaving
fontego admin users disable EMAILstops someone from signing in and closes their sessions and tokens;enablelets them back.fontego admin users remove EMAIL --yesdeletes the account at once. Its history stays.
Sessions
Every browser and CLI that signs in opens a session, which ends when it goes unused for some days, or at a maximum age:
30 and 90 days by default, set apart for the web and the CLI with the sessions.* settings
(Configuration). Lowering either shortens open sessions at once.
fontego admin sessions --user ana@example.org
fontego admin sessions close IDTokens
Tokens are for scripts and agents that run on their own. They don't expire.
fontego admin tokens create ana@example.org --label "backup job" # for Ana
fontego admin tokens create ana@example.org --agent --label "nightly" # for Ana's agent
fontego admin tokens --user ana@example.org
fontego admin tokens revoke IDA token is shown once, and the server keeps only its hash. fontego admin users add EMAIL creates an account without a
password, for tokens only.
Who did what
fontego admin audit --user ana@example.org --since 2026-11-01 # the access log
fontego admin audit changes --workspace notes # who wrote each commitBoth note the agent when a call came from one.