First-run setup
Updated
The first time you open Virtainer Free in a browser, it takes you through a setup wizard instead of the console. The wizard is not optional: the host has no administrator account and no storage pool until you finish it.
Plan for the host to reboot at the end, and for the browser to lose the connection for a minute or two.
What the wizard asks for
Section titled “What the wizard asks for”-
Network
The page lists the wired Ethernet interfaces the host detected, with their link state and which one carries the default route. Then you choose the result you want, and a plan on the right shows what will happen before anything changes:
- Keep management separate: the management interface keeps its address, and VMs use the other interfaces.
- Host and VMs share one uplink: the host and the VMs share one interface and one LAN segment.
- Bond the NICs: free interfaces become one management uplink.
Wi-Fi is not supported. If no wired interface is available, connect an Ethernet adapter and cable before continuing.
An option the hardware cannot support is listed with the reason. A host with one interface can only share it. With several interfaces, pick the Management NIC, and choose DHCP or a static address for the management network. Advanced: edit topology is there for layouts the three results do not cover. Finish with Review and apply.
If your change moves the host to a different address, Virtainer Free applies it as a trial and reopens the wizard at the new address. Press Keep this network from there within five minutes. If you do not, or you press Discard (revert), the host rolls the change back on its own, which recovers an address that was wrong. While a change is waiting for your answer the wizard cannot be finished and the host cannot be rebooted, and signing in again returns you to this step.
The window recovers a configuration the host can still live without. It is not a rescue for a change that removes the link itself, and a rollback cannot be confirmed from a machine you cannot reach. When you are editing the bridge that carries the host’s only reachable interface, have console access to the machine, or someone who can power-cycle it, before you apply.
-
Storage
Review the disks the host found and create a storage pool. This is where virtual machine disks, cached images, and data volumes live.
You can choose Skip (no pool) and create the pool later from the Storage page, though skipping stores machine data on the system disk, and a pool cannot be added once machines exist.
A host with no disk that could hold a pool has nothing to choose: the step says storage will live on the system disk and offers Continue. Add a disk later and a dedicated pool can be built from the Storage page.
-
Host
Under Host identity, set the hostname and time zone. Under Administrator, create the host’s one account. Its username and password sign in to the console and to the host itself (console login, SSH, sudo); the host has no direct root login, and root cannot sign in over SSH even with a key. The wizard offers a generated password that you can replace (at least 8 characters) and shows it only here, so save it before you continue. This is also where you can paste an SSH public key and choose whether SSH is allowed (Allow SSH).
The wizard has three steps. Choosing Finish & reboot on the last one, and confirming, reboots the host from within it, and the step shows Rebooting the host while it does. The reboot is required, because it clears the install-time boot settings and brings the host up in its normal running configuration. There is no fourth step to confirm.
After the reboot
Section titled “After the reboot”Open the host’s address again and sign in with the administrator account you created. You land on the Dashboard, and the sidebar has the full console.
There is no activation step, no license key, and no product to register.
If the wizard reappears
Section titled “If the wizard reappears”The wizard only runs while setup is incomplete. If you see it again after finishing, the host was reset (see Danger Zone) or the setup never actually completed. Sign-in problems are different: those send you to the login page, not to the wizard.