Installation

Install HAProxy Enterprise as a VM image

Installing the virtual machine image presents an alternative method of getting HAProxy Enterprise that works in an air gapped environment.

Verify the OVA image’s checksum Jump to heading

To check the integrity of the .ova image before installation:

  1. Download the .ova file and the SHA256SUMS file from the repository:

    text
    https://www.haproxy.com/download/hapee/key/<HAPROXY ENTERPRISE KEY>-vmware
    text
    https://www.haproxy.com/download/hapee/key/<HAPROXY ENTERPRISE KEY>-vmware
  2. The SHA256SUMS file contains checksums for the .ova files:

    SHA256SUMS
    text
    ae43142589b3ee... hapee-rhel-8-amd64-2.6r1-20250121.ova
    06ca84c7da61bf... hapee-rhel-9-amd64-2.8r1-20250121.ova
    f01a2a6263ebfe... hapee-rhel-9-amd64-2.9r1-20250121.ova
    ...
    SHA256SUMS
    text
    ae43142589b3ee... hapee-rhel-8-amd64-2.6r1-20250121.ova
    06ca84c7da61bf... hapee-rhel-9-amd64-2.8r1-20250121.ova
    f01a2a6263ebfe... hapee-rhel-9-amd64-2.9r1-20250121.ova
    ...
  3. Get the checksum for the .ova file you downloaded. For example:

    Use the command shasum to get the checksum of the .ova file:

    nix
    shasum -a 256 hapee-rhel-9-amd64-3.0r1-20250121.ova
    nix
    shasum -a 256 hapee-rhel-9-amd64-3.0r1-20250121.ova
    output
    text
    eac5f1f35a386dec73c0bef8769848014f76d0cf7688a651538c1d89cc3e4e4b hapee-rhel-9-amd64-3.0r1-20250121.ova
    output
    text
    eac5f1f35a386dec73c0bef8769848014f76d0cf7688a651538c1d89cc3e4e4b hapee-rhel-9-amd64-3.0r1-20250121.ova

    Use the PowerShell command Get-FileHash to get the checksum of the .ova file:

    powershell
    Get-FileHash hapee-rhel-9-amd64-3.0r1-20250121.ova
    powershell
    Get-FileHash hapee-rhel-9-amd64-3.0r1-20250121.ova
    output
    text
    Algorithm Hash
    --------- ----
    SHA256 EAC5F1F35A386DEC73C0BEF8769848014F76D0CF7688A651538C1D89CC3E4E4B
    output
    text
    Algorithm Hash
    --------- ----
    SHA256 EAC5F1F35A386DEC73C0BEF8769848014F76D0CF7688A651538C1D89CC3E4E4B
  4. Verify that the checksum matches the line for that .ova in the SHA256SUMS file.

Install the OVA image Jump to heading

Hypervisor support

The OVA virtual machine image applies to:

  • VMware

To install the OVA image:

  1. Import one of the .ova files from the VM Templates repository into your VMware hypervisor. Each file installs a different version of HAProxy Enterprise on Ubuntu or Red Hat Enterprise Linux. Replace <HAPROXY ENTERPRISE KEY> in the following URL with your HAProxy Enterprise license key to access the repository.

    text
    https://www.haproxy.com/download/hapee/key/<HAPROXY ENTERPRISE KEY>-vmware
    text
    https://www.haproxy.com/download/hapee/key/<HAPROXY ENTERPRISE KEY>-vmware
  2. When you import the OVA file into your VMware hypervisor to create a new virtual machine, you will be asked to provide:

    • a name for the virtual machine (example: hapee-vm)
    • a storage path for the virtual machine (prefilled automatically, but you can change it)
    • a unique instance ID for the VM instance (example: hapee1)
    • a hostname for the VM instance (example: hapeevm)
    • an SSH public key for connecting to the instance (example: ssh-ed25519 ABCD... My PC)
    • the default user’s password (example: mypassword)

    If you don’t provide a password, a random one will be generated. It will display above the sign-in prompt in the terminal.

  3. Log in with the username ubuntu or cloud-user and the password you set during the installation.

Do you have any suggestions on how we can improve the content of this page?