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.
143#+begin_src sh 143#+begin_src sh
144gitbayd admin audit [--limit n] # host-local 144gitbayd admin audit [--limit n] # host-local
145ssh git@<host> audit [--limit n] # instance admins, SSH only 145ssh 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
146gitbayd admin user disable <name> # suspend: SSH, web, API all refused; 148gitbayd admin user disable <name> # suspend: SSH, web, API all refused;
147gitbayd admin user enable <name> # sessions dropped, nothing deleted 149gitbayd admin user enable <name> # sessions dropped, nothing deleted
148gitbayd admin user delete <name> --yes # only for accounts anchoring nothing: 150gitbayd 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:
152 # org's only admin 154 # org's only admin
153#+end_src 155#+end_src
154 156
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
155=limits.ssh_auth_rate= (10) throttles per-IP authentication *failures* 164=limits.ssh_auth_rate= (10) throttles per-IP authentication *failures*
156per minute — successful auths never count and clear the slate. 165per minute — successful auths never count and clear the slate.
157=limits.max_pack_bytes= is enforced as =receive.maxInputSize= on every 166=limits.max_pack_bytes= is enforced as =receive.maxInputSize= on every