Getting started: The LogonBox Setup Wizard (version 2.3+)

Christopher Dakin

Note: This article applies to LogonBox version 2.3.0 and later.


After you have deployed your LogonBox server and booted the system up, the first step is to visit the web GUI on https://<your hostname>.

As this is your first visit to the server, you must now complete the Setup Wizard to give you an initial configuration of the server. This article will guide you through this process.


1. License Agreement

Review the license agreement and tick the I accept the terms of the license agreement tickbox when satisfied.

Click Next to continue.


2. Set Password

You now need to configure the administrator account which will have full System Admin privileges.

First, choose a username you want for this account (e.g: admin).

Then choose and confirm a password. Ensure that this is a strong password as this is the most sensitive account on the system.

There is a Local Account Default Password Policy which is displayed below the password, which you must match in order for the password to be accepted (this policy may be changed later if you wish).

The password policy is checked live as you type. If the password passes the Policy test, you should see Password looks good.

Note: At this step, the service will check if your password has appeared on the HaveIBeenPwned service. If you get the below error:

then click BackNext and enter a new password.

Click Next to continue the wizard.


3. Configure External Access

In order for the server to be able to get access to product updates and installable features, it must be able to connect outbound to the internet.

If the server already has connectivity, just click Next to continue.


If you need to connect out via a Proxy Server instead, tick the I need to configure the proxy settings to allow access to the update server box.

Set the Proxy Type to either HTTP or SOCKS, then enter the Proxy Host and Proxy Port, then click Next.


4. Registration Details

Enter your NameCompany Name and Email to register your new LogonBox server.

Click Next to continue.


5. Download/Install Components

Click Next on Step 5 and the setup will automatically connect to the internet to download the latest version of the server and install any extra components required.


6. Scheme Setup

You can now select which Authentication Flows to set up 2-factor authentication for.

Password Reset and Account Unlock are always selected but you can optionally apply some default 2FA to any of the other schemes by ticking them.

Click Next to continue.


7. Authentication Setup

Now you can select which authentication methods you want to enable for your users to use.

Selecting at least 2 methods allows users to have a backup option for authentication should they forget one of their credentials.

Whatever you configure here, these settings can be changed later. See separate article on User Selective Authentication for more details.

Select some methods and set the Minimum Factors that a user needs to answer when running through the authentication flow (defaults to 1).

Click Next to continue.


8. Setup Complete

The setup wizard is now complete. Click Restart and the server will now restart.


Once the server restarts you will be looking at this view and you can now start using the system: