vME Setup Wizard - First Boot
Purpose
This guide explains the first-boot setup wizard for vME operators.
The setup wizard is a one-time guided flow in the web UI. After you click Finish, it locks permanently and all wizard write APIs return 410 Gone. Normal login is used from then on.
Prerequisites
| Item | Detail |
|---|---|
| Appliance deployed | OVA (VMware) or VHDX package (Hyper-V), deployed manually. See the VMware Install Guide or Hyper-V Install Guide. |
| Network | Appliance has an IP (DHCP or static) and you can reach it on HTTPS |
| Browser | https://<appliance-ip>/ - accept the installer self-signed certificate warning on first visit if prompted |
| Default login | admin / admin (change during the wizard) |
First boot walkthrough
1. Deploy the appliance
Deploy the vME image for your platform: OVA (VMware) or VHDX package (Hyper-V). Complete the platform-specific steps in the install guides linked above.
2. Find the appliance IP and open the web UI
Obtain the appliance IP from DHCP (hypervisor networking view), the VM console (often shown on screen after boot), or by logging in on the console and running ip addr.
Browse to:
https://<appliance-ip>/
Log in with the default credentials admin / admin (you will change the password in the wizard).
3. Walk through the wizard
Work through the steps in order. Each screen is shown below, along with whether it is required before you can finish. The wizard opens on a welcome screen:
Network (optional)
Set the hostname and NTP server, and configure IPv4 networking with netplan: choose DHCP, or enter a static IP with gateway and DNS. Network changes are applied when you finish the wizard.
With DHCP, the appliance obtains its IPv4 address automatically - you only set the hostname and NTP server:
With Static IP, enter the IP address, netmask/prefix, default gateway, and DNS servers. After you finish the wizard the appliance moves to the static address, so reconnect there to log back in:
TLS (required)
Keep the self-signed certificate (fine for a lab), or install your own from PEM files on the appliance, with an optional CA bundle.
Self-signed:
Provide a certificate:
Licence (required)
Enter your licence key to activate the appliance.
Reset password (required)
Change the default admin password.
Authentication (required)
Choose Local (default) or LDAP.
Local:
LDAP:
Timezone (required)
Select your region and UTC offset.
Pool (optional)
Create an initial storage pool now, or skip and create pools later from the main UI.
Finish
Review and finish. The wizard locks and redirects you to the login page.
4. After setup
- Log in with the new admin password.
- Configure sources, pools (if skipped), and the rest of vME from the normal UI.
The setup wizard is a one-time flow and locks once finished. If you need to reset the appliance or re-run the wizard, contact enov8 Support.
Related documentation
- VMware Install Guide: deploy the OVA on VMware ESXi
- Hyper-V Install Guide: deploy the VHDX package on Hyper-V