| docs

Appearance

User Management Commands ​

These commands help you manage customer accounts in the AdminBolt system.

bolt-cli create-admin-account ​

Creates a new administrator account in the system.

Example: ​

bash
bolt-cli create-admin-account

This command will prompt you for the necessary information to create a new admin account, including:

  • Admin name
  • Email address
  • Password

The command prevents the creation of duplicate admin accounts with the same email address.

bolt-cli reset-admin-account-password ​

Resets the password for an existing administrator account.

Example: ​

bash
bolt-cli reset-admin-account-password

This command will interactively prompt you for:

  1. Admin username or email address - the same name the admin sign-in form takes
  2. New password

Usage Example: ​

bash
$ bolt-cli reset-admin-account-password
Resetting admin account password...
Enter username or email: admin
Enter password: ********
Admin account password reset successfully for admin

Important Notes: ​

  • Since panel 1.9.4 the command names the administrator the way the sign-in form does: by username, or by an email address exactly one administrator account has, compared without regard to letter case. Before 1.9.4 it took an email address only, which an administrator set up through onboarding did not have.
  • An error message is displayed if no admin account has that username or email address
  • Passwords are securely hashed before storage
  • Password input is hidden for security

bolt-cli admin-sso-generate ​

Prints a one-time login URL that signs you in to the admin panel without a password.

Options: ​

  • --admin: The administrator username to sign in as. An unknown name is refused; the command never creates an account for it. Available since panel 1.9.0.
  • --expire: How long the link stays valid, for example 30m, 2h, 24h, or 7d.

Example: ​

bash
bolt-cli admin-sso-generate --admin=jane

The command prints the administrator the link signs in as, then the URL.

Without --admin, the link signs in as admin while that account exists, and otherwise as the oldest remaining administrator. The link does not recreate a deleted admin account and does not force a password change. A new administrator account is created only when the server has none at all.

Warning: The URL signs anyone who opens it in as an administrator. Treat it like a password: do not paste it into tickets, chats, or logs, and open it only on a machine you trust.

bolt-cli set-admin-password ​

Sets the password for the administrator account. The administrator login is always admin. This command is intended for unattended installations, where you set the admin password without using the one-time SSO login URL.

Options: ​

  • --password: The password to set. When omitted, the command generates a strong 20-character password and prints it to stdout.

Example: ​

bash
bolt-cli set-admin-password

The password is temporary: the panel requires the administrator to change it at first sign-in.

Warning: A password passed with --password on the command line can be recorded in your shell history. Prefer the generated password, or clear the relevant history entry afterward.