18.3. Configure the Appliance with the Setup Wizard

With the operating system installed, the appliance serves a setup console on port 8080. Here you redeem your install code, create your first tenant and administrator, and start the deployment. If you have not installed the OS yet, start with Install the operating system.

You need two things from the previous stage: the setup URL and the one-time setup token from the console banner. You also need the install code from your registration email.

Open the setup console

In a browser on the same network, open the setup URL from the console banner, for example http://192.168.122.55:8080/.

The console opens on the token screen.

Figure 1: Enter the one-time setup token from the console banner.

1. Type the setup token. The token proves you have access to the machine's console, so no one else can claim the appliance.
2. Select Continue.

Set a management password

The token is single-use. Replace it with a password you will use to sign in to the setup and status console from now on.

Figure 2: Choose a management password for the setup and status console.

1. Enter a password with at least 8 characters, including uppercase, lowercase, a number, and a special character.
2. Confirm it and select Set password and continue.

This management password is for the console on port 8080 only. It is separate from the AlgaPSA administrator account you create next.

Enter your install code and configure the first tenant

The setup form reads the network details from the host. You provide the install code and the details of your first tenant.

Figure 3: The setup form, completed for Northpoint Technology Group.

1. Enter your install code from the registration email. This binds the appliance to your tenant and applies your edition automatically.
2. Enter the company name. This becomes your first tenant and your default client company. In the example, that is Northpoint Technology Group.
3. Create the administrator account: first name, last name, email, and a strong password. This email is what you sign in with after setup completes.
4. Confirm the App URL. The default is the host's own address on port 3000 and works out of the box. Use the full URL your team will type in their browser.
5. Leave the release channel on stable and DNS on system unless support tells you otherwise.
6. Select Save and continue.

The release channel and DNS mode have sensible defaults. Change them only when Nine Minds support asks you to.

Watch the deployment

After you submit the form, the console switches to the status view. The appliance begins deploying. It runs preflight checks, brings up its internal services, pulls the application images, runs database migrations, and creates your tenant and administrator.

Figure 4: The status console reports progress through readiness tiers while the application deploys.

The deployment runs on its own and usually takes several minutes, depending on your connection speed for the image pulls. The status view shows readiness tiers (platform, core, login) moving from pending to ready. A Login URL appears once the application can serve sign-in.

You can leave this page open and watch, or come back to it. When the core application reports ready, you are clear to sign in.

What to check

• The status view leaves the install-code step without an error. If it reports it cannot redeem the install code, confirm the host has outbound HTTPS to license.nineminds.com. The appliance retries on its own once you open the access.
• The Login URL on the status view points at your App URL on port 3000.
• The core application reaches ready. Background services may still be settling, which is expected immediately after a first deploy.

When the application is ready, continue to First sign-in and guided onboarding.