First run ​
The first time you open AdminBolt after installing it, the panel asks two questions and then hands you your logins. This takes under a minute and happens once.
Step 1: how you will use the server ​
AdminBolt can work out almost everything about your server on its own. The one thing it cannot work out is what you intend to do with it, so it asks:
- Host my own websites. AdminBolt creates your first hosting account straight away, along with a temporary website address you can use before your own domain points at the server.
- Provide hosting to clients. AdminBolt starts you on hosting plans instead, and you add an account per client when you are ready.
Neither choice locks you in. You can create accounts, plans, and resellers later whichever path you take.
Step 2: your admin account ​
Since panel 1.9.5, an administrator who came in through the installer's one-time link, or whose password was set with bolt-cli set-admin-password, is taken to this step before any other page, including License and Agents: "You came in through the one-time sign-in link the installer printed. Now set your own password, and we will hand you everything to save on the next screen." On a server that is already set up, only the password is asked for: "Set a new password that only you know before you go on."
The installer set a temporary password. Replace it here, and fill in:
- Email address - where AdminBolt writes to you about this server. Since panel 1.9.4 it is saved on your administrator account, so you can sign in with it as well as with the username. An address another administrator already uses is refused with "Another administrator already uses this email address."
- First name and Last name - optional since panel 1.9.4. Left empty, the panel shows your email address where it would show your name.
- Username - the name you will sign in with. Since panel 1.9.5 the rule depends on the choice in step 1:
- Host my own websites - the name is also the login of your first hosting account: 5 to 32 characters, lowercase letters, numbers, dashes, or underscores, starting with a letter.
- Provide hosting to clients - the name of your administrator account, checked with the same rule as a new administrator on Admin Management: 3 to 32 characters, lowercase letters, numbers, dots, dashes, or underscores, starting with a letter, and free on the server.
- New password - AdminBolt generates one for you. Keep it, generate another, or type your own. It has to be at least 10 characters.
Since panel 1.9.4 each field is marked Required or Optional, and the error messages of a previous attempt disappear as soon as you continue, so only the errors of the new attempt are shown.
On a server onboarded before 1.9.4, the update puts the address entered during onboarding on the administrator account, when the server has one administrator and that account has no address yet. To change the address later, open My Profile from the user menu at the top right of the admin panel, added in 1.9.4.
Root sign-in ​
Since panel 1.9.5, root can sign in to the admin panel with the server's root password from the install, so you can get in even without the installer's link. The setup wizard asks whether to keep it, under Keep the root password off the web:

- Turn off root sign-in - recommended and selected for you. Only your admin accounts sign in to server administration.
- Keep root sign-in on -
rootcan still sign in with the server's root password. Wrong tries count towards a Fail2Ban ban.
You can change the choice later with the Root sign-in button on Admin Management.
Your logins ​
The last screen hands you two separate sets of credentials, because a server has two jobs and they are kept apart:
- Server administration at
/admin. This is where you manage websites, mail, DNS, backups, and every server setting. Since panel 1.9.0 the Username or e-mail field of the admin sign-in accepts an administrator's e-mail address as well as the username, when exactly one administrator uses that address. - Your hosting account at
/client. This is where you manage the files, databases, and mailboxes of one account, the same view your customers get. The screen also gives you a temporary website address, so you can put a site up before your domain's DNS moves. Since panel 1.9.4, when that address is on the server's free temporary domain, the screen warns that mail sent from it may fail SPF and DKIM checks at other mail providers: use your own domain for mail. See Mail on a free temporary domain.
Signing in ​

Since panel 1.9.5, the admin sign-in page is headed Sign in to server administration. Its Username or e-mail field takes the administrator's username or the e-mail address entered in the setup wizard. Before the setup is finished, the page says that you can sign in as root with the server's root password, or run bolt-cli admin-sso-generate on the server for a one-time link. Open the hosting panel at the bottom leads customers to their own sign-in.
The sign-in pages of the admin, reseller, and client panels have a language menu next to the theme switch since panel 1.9.5. The browser keeps the choice, and it becomes the account's language at sign-in when the account has not chosen one.
Since panel 1.9.4, the sign-in forms of the admin, reseller, and client panels:
- remove spaces around the username, for example when it was pasted with a space at the end,
- leave the password exactly as typed, because a space can be part of a password. When a refused password starts or ends with a space, the form says so under the password field: "The password you entered starts or ends with a space. If you pasted it, remove the space and try again." The attempt still counts as a failed sign-in.
After you sign in, each panel opens the page you were sent to the sign-in from only when that page belongs to the same panel; otherwise it opens its own home page. An admin sign-in therefore always leads to the admin panel, also when the browser was last on a client page.
Warning: The passwords on this screen are shown once and never again. Use Copy all, Download, or Email to me before you continue. Downloading or copying is safer than mail, which goes out in plain text.
If you lose the admin password later, generate a one-time sign-in link on the server itself:
bolt-cli admin-sso-generateCannot sign in? ​
Since panel 1.9.5, Cannot sign in? on the admin sign-in page lists the ways back in. There is no reset by e-mail: each goes through the server, over SSH as root or in the console your hosting provider offers.

- Get a one-time sign-in link with
bolt-cli admin-sso-generate. Open the link it prints in the same browser. - Set a new password with
bolt-cli reset-admin-account-password. Add a username or e-mail address after it for another administrator. - Sign in as root with the server's root password, before the setup is finished.
- Banned after failed tries? Lift the Fail2Ban ban on your address and keep it from being banned again with
bolt-cli fail2ban-unban <your IP> --whitelist.
Every failed sign-in counts towards a Fail2Ban ban of your address, so use one of these ways instead of guessing.
Activating a licence ​
A new server starts unlicensed, and the panel keeps every screen behind the License page until a licence is in place. You have two ways in:
- Start a free trial. Enter your email address on the License page. The trial activates immediately for 24 hours, and AdminBolt mails you a confirmation. Open the link in that mail and press Confirm on the page it opens to extend the trial to the full period, as the trial message on the License and Onboarding pages says. No card is required. Since panel 1.9.4 the License page checks the confirmation again as soon as you come back to its tab or window.
- Enter a licence key you already hold, and validate it.
You can also activate the trial while installing, by passing your address to the installer:
sudo ./install.sh [email protected]Without --email the installation finishes unlicensed, and you activate on the License page whenever you are ready.
Note: A licence is tied to the server's IP address. Moving the panel to another address needs the licence reissued for the new one.