HAProxy ALOHA Documentation 15.5

VMware VSphere

Follow these steps to install HAProxy ALOHA on KVM.

  1. From the HAProxy Technologies Customer Portal, create a new support ticket to request your download credentials.

  2. Browse to the URL https://www.haproxy.com/download/aloha/15.5/va-installer. Enter your credentials to access the folder.

  3. Download the file aloha-albva-vsphere.zip and extract its contents.

  4. Open vCenter (such as via the vSphere Client) and create a new virtual machine:

    1. Right click on your datacenter and choose Deploy OVF Template.

    2. Choose Local file and then upload the files aloha-albva.ovf and aloha-albva-disk1.vmdk.

    3. Complete the wizard to import the virtual machine.

Assign an IP address

You must assign an IP address belonging to the internal network to your HAProxy ALOHA appliance. Although you have the option of using DHCP to assign an IP address dynamically, which is useful for connecting to the HAProxy ALOHA for the first time before you've set up a static IP, it is typical to prefer a static IP, since you will want HAProxy ALOHA to have a predictable address on your network.

When starting your appliance for the first time, you can either:

  • use DHCP to assign an IP address dynamically, then assign a static address either through the web user interface or the CLI, or

  • assign a static address to the appliance immediately.

Once you have assigned an IP address, you can then connect to the HAProxy ALOHA web UI and change IP address assignments using the graphical interface.


By default, DHCP automatically assigns an IP address to your HAProxy ALOHA virtual appliance at first boot.

  1. Start your virtual appliance.

    The following message displays:

    Retrieve IP using DHCP or configure static ... 10sec (D/s)?
  2. Enter D for DHCP or wait for 10 seconds.

    The web UI's URL displays, for example:

    Access WEB User Interface:

Later, you should assign a static IP address to the appliance.

Assign a static IP address

  1. Start your appliance.

    The following message displays:

    Retrieve IP using DHCP or configure static ... 10sec (D/s)?
  2. Enter s to enter a static IP address.

    The following message displays:

    Configure IP manually
    Use IP address (
  3. Enter the IP address you want to assign to the appliance.

    The following message displays:

    Use netmask (
  4. Enter the netmask you want to assign to the appliance.

    The following message displays:

    Use default gateway (
  5. [Optional] Enter the IP address of the appliance's default gateway.

    The following message displays:

    Commit and save this configuration (N/y)?
  6. To save your configuration, enter y.

    The web UI's URL displays, for example:

    Access WEB User Interface:

You can now access the HAProxy ALOHA web UI at the address http://<IP Address>:4444/.

Log in to the web user interface

Copy the Access WEB User Interface address that's displayed when you connect to the command-line terminal. This takes you to a login screen.

To log in, use the username and password admin.

Once logged in, run the initial configuration wizard.

OVF properties

Open Virtualization Format (OVF) is an open-source standard for packaging and distributing software applications for virtual machines (VM).

In HAProxy ALOHA, you can use OVF properties in VMWare to set parameters on your virtual machine and have them apply automatically on boot.





Specifies the hostname that the virtual machine should have when it is deployed. During the deployment process, this value will be used to assign the hostname to the VM. For example, if you set hostname to "my-vm", the VM will have the hostname "my-vm" when it starts up.



Represents the initial administrative or root password set for the virtual machine's operating system. During deployment, this password is usually used to set up the initial login credentials for the VM's administrator or root account. It's important to secure this value because it provides access to the VM's administrative functions.



This property is related to the initial IP address configuration of the virtual appliance, often used in VMware vCenter Server Appliance (VCSA) deployments.


Corresponds to the netmask or subnet mask for the IP address specified in vami.ip0.aloha. It defines the network range to which the IP address belongs, helping determine which other devices are in the same network.


Represents the gateway or router IP address that the virtual appliance should use for outbound network traffic. The gateway is crucial for routing traffic between the virtual appliance and external networks or the internet. Ensure that the provided IP address is a valid gateway for the network.


Specifies the DNS server that the virtual appliance should use for name resolution. Proper DNS configuration is essential for the virtual appliance to resolve domain names to IP addresses. This ensures that the appliance can access external resources using domain names.

You can define the OVF properties using the VMWare user interface or the command line.

Define OVF properties in the VMWare UI

  1. Extract aloha-albva.ovf and aloha-albva-disk1.vmdk from the aloha-albva-vsphere.zip archive you were provided by HAProxy Technologies.

  2. Log in to VMWare ESXi.

  3. Create a new virtual machine. Select Deploy a virtual machine from an OVF or OVA file as the creation type.

  4. Enter the name of your appliance, and select aloha-albva.ovf and aloha-albva-disk1.vmdk.

  5. Specify the additional settings of your appliance including items such as the IP Address, Netmask, and Default Gateway.

  6. Deploy your virtual appliance.

Define OVF properties using the command line

  1. Define your OVF properties using the command line with your network information, as follows:

    $ sudo ovftool --overwrite --name=<hostname> \
    --network="<network name>" --X:logLevel=verbose --X:injectOvfEnv  --powerOn \
    --prop:vami.ip0.aloha=<IP address> --prop:vami.netmask0.aloha=<subnet mask> \
    --prop:vami.gateway.<Gateway IP address> \
    aloha-albva.ovf vi://<username>:<password>\!@<VMware ESXi IP address>
    $ sudo ovftool --overwrite --name=MYALOHA --network="VM Network" \
    --X:logLevel=verbose --X:injectOvfEnv --powerOn \
    --prop:vami.ip0.aloha= --prop:vami.netmask0.aloha= \
    --prop:vami.gateway. aloha-albva.ovf vi://jdoe:Stc1fl15oGv4\!@
  2. Log in to your VMware ESXi™ account.

    Your virtual appliance is up and running.

See also

Next up

VMware Workstation Player