Skip to Content
FontegoDocs

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 EMAIL sends someone a link.
  • When nobody can sign in, or there is no mail, fontego-server admin-link EMAIL on 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 EMAIL stops someone from signing in and closes their sessions and tokens; enable lets them back.
  • fontego admin users remove EMAIL --yes deletes 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 ID

Tokens

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 ID

A 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 commit

Both note the agent when a call came from one.

On this page