Commit 61d2f4d3f3

61d2f4d3f3e80002b73954ad8796eba586f783c0

parent: 86a293b4bf

Verified · cmc

cmc <hello@cleberg.net> · 2026-09-02 00:40 UTC

Admin: document admin user list and show

Ref krz/gitbay#69

Layout: unified · split

Admin.org +9
@@ -143,6 +143,8 @@ never in argv.
143143#+begin_src sh
144144gitbayd admin audit [--limit n] # host-local
145145ssh git@<host> audit [--limit n] # instance admins, SSH only
146ssh git@<host> admin user list [--state active|pending|disabled|admin]
147ssh git@<host> admin user show <name> # keys, emails, orgs, tokens, sessions
146148gitbayd admin user disable <name> # suspend: SSH, web, API all refused;
147149gitbayd admin user enable <name> # sessions dropped, nothing deleted
148150gitbayd admin user delete <name> --yes # only for accounts anchoring nothing:
@@ -152,6 +154,13 @@ gitbayd admin user delete <name> --yes # only for accounts anchoring nothing:
152154 # org's only admin
153155#+end_src
154156
157=admin user list= pages by username (=--limit=, =--cursor=) and carries
158each account's state and =last_seen=, the newest use of any of its SSH
159keys or API tokens. =admin user show= adds the keys with their last use,
160each address with how it was verified, PGP keys, org roles, the owned
161repository count, API token names, and live browser sessions. Both are
162SSH-only and refused to non-admins, like =audit=.
163
155164=limits.ssh_auth_rate= (10) throttles per-IP authentication *failures*
156165per minute — successful auths never count and clear the slate.
157166=limits.max_pack_bytes= is enforced as =receive.maxInputSize= on every