Skip to content

Bootstrap the first admin ​

After the process can start, create the first web account on the machine that runs the binary. This is CLI, not self-registration. Finish this page before Admin → Quick start.

kirivers admin reads only the system YAML (PostgreSQL DSN), not admin.yaml.

Create ​

  1. Open a terminal in the directory that holds the binary and YAML files (or pass -config).
  2. Run:
bash
kirivers admin add alice
  1. Set the password at the prompt (or -password). Success:
text
created alice (<uuid>)
  1. Open the admin plane (default http://127.0.0.1:8081) and sign in. The first login must enroll TOTP (see Sign-in and 2FA).

Other actions ​

CommandEffectSuccess stdout
kirivers admin listList instance adminsHeader USERNAME ID CREATED_AT
kirivers admin reset-password aliceReset passwordpassword reset for alice
kirivers admin clear-2fa aliceClear TOTP / passkeys / recovery codescleared 2FA for alice
kirivers admin delete aliceDelete the accountdeleted alice

clear-2fa does not revoke existing sessions. Deleting the last instance admin fails (LAST_ADMINCannot delete last admin).