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.

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. Upload license

For the license, click Choose File and load your license here which should have been emailed to you when you registered.

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. 2FA Setup

You can now select which 2 factor authentication methods you want to allow your users to choose from. Selecting at least 2 methods allows users to have a backup option for authentication should they forget one of their credentials.

You can opt to skip this step and manually configure later, but if you select some modules at this stage they will be automatically configured as the defaults for you. See separate article on User Selective Authentication for more details.

Select some methods or tick 'I don't know' then Next to continue.


7. Configure SSL certificate

You can now generate a new SSL certificate or upload your own already signed certificate.

To upload your own, select Upload an existing private key and certificate and load your Private Key with its password, as well as the certificate and the CA bundle.


If you wish to just generate a self signed certificate for you (which you can use to generate a CSR for signing later), then select Generate a certificate.

Enter the detalils for your certificate, noting that the Common Name needs to be the hostname that your users will be accessing the server on. Click Next when ready.


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


Important Note: As a new SSL certificate is being created at this stage, it's not possible for the page to automatically reload properly, as the browser needs to be refreshed in order to accept the new certificate.

Therefore wait a minute, then reload the main URL https://<yourserverhost>


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