Skip to main content

Installing Gallium Edge

You install Gallium Edge by booting the server from the bootstrap image, then registering it in the Gallium Console. Registration continues straight into creating the Storage Pool, which erases the selected disks and installs the operating system on them.

Before You Begin​

Confirm the following before you start:

  • UEFI boot mode: The server must boot in UEFI mode, not legacy BIOS.
  • Hardware virtualization: Intel VT-x (or the AMD equivalent) must be enabled in firmware.
  • Networking: Gallium expects a DHCP-assigned address by default. For a fixed address, review static IP strategies first.
  • Disks: Two disks of matching capacity for a mirrored Storage Pool. See Hardware.
  • Clean egress: The installer and the running server must reach the Gallium servers over TLS. If your network performs SSL inspection, bypass it for this server. See SSL whitelisting.

Start using the Bootstrap Image​

  1. In the Console, open the Deployments page, select New Deployment, then Edge, and download the Gallium Edge Bootstrap Image.
  2. Flash the image to a disk, USB drive, or SD card with Etcher or directly to the first disk using your hosting provider's imaging tools.
  3. Power on the server and set it to boot from the flashed media or disk.
  4. Note down the Join Code on the screen once the server has started.

Register and Configure the Hypervisor​

  1. On the Add Edge Hypervisor page, enter a Hypervisor Name.
  2. Enter the Join Code shown by the server, a nine-character code in the form XXX.XXX.XXX.
  3. Select Add Hypervisor. The Console connects to the server, which takes a few seconds, then displays the storage configuration.
  4. Under Storage Pool Layout, choose Mirror or Single Disk.
  5. Under Select Disks, select the disks for the pool. Disks that cannot be used are grayed out.
  6. Select Continue to Confirmation.
  7. All data on the chosen disks will be erased. To confirm, type the displayed key into Enter the Key to Continue and select Create Storage Pool.
note

When the wizard completes, the hypervisor reboots once. This may take a few minutes; wait for the hypervisor to show Online before continuing.

Next Steps​

Troubleshooting​

If the server stays Pending and never comes Online:

  • Disable SSL inspection: An SSL-inspecting firewall or proxy prevents the server from establishing a secure connection. See SSL whitelisting.
  • Check the system clock: An incorrect BIOS clock causes TLS certificate validation to fail.
  • Confirm virtualization is enabled: Verify Intel VT-x (or the AMD equivalent) and KVM support in firmware.