Server & admin

Commands that run on the bhatti server itself, plus a couple that work from any client (setup, version, completion, update).

Categories

Daemon	serve
Client config	setup, version, completion
Updates	update
User management	user create, user list, user rotate-key, user delete
Observability	admin status, admin events, admin metrics

Server-only commands

user * and admin * operate directly on the server’s SQLite database (/var/lib/bhatti/state.db). They aren’t HTTP API calls — they need filesystem access to the database. Run them on the server, typically with sudo.

serve runs the daemon. Also server-only by definition (requires KVM and root).

The remaining commands (setup, version, update, completion) work from any client.

Quick patterns

# Bootstrap a new user (server)
sudo bhatti user create --name alice --max-sandboxes 10

# Check overall health (server)
sudo bhatti admin status

# Find recent thermal pauses (server)
sudo bhatti admin events --type thermal --since 24h

# Update the CLI on a developer machine
bhatti update

# Update everything on the server (CLI, kernel, rootfs, lohar)
sudo bhatti update