Skip to main content

August 24, 2026

Allow Omnissa Horizon Web Client Through a Load Balancer

Note: Omnissa Horizon Web Client is available with Horizon 8 versions 2412 and later. For Horizon 8 versions 2406 and earlier, Horizon Web Client is called "HTML Access." This documentation page uses the name "Horizon Web Client" to refer to both Horizon Web Client and HTML Access.

Omnissa Horizon Connection Server instances that are directly behind a load balancer or load-balanced gateway must know the address by which browsers will connect to the load balancer when users use Horizon Web Client.

For Horizon Connection Server instances that are directly behind a gateway, perform the procedure described in Allow Omnissa Horizon Web Client Through a Gateway.

You must perform this procedure for each Horizon Connection Server that is behind the load balancer or load-balanced gateway.

Procedure

  1. Create or edit the locked.properties file in the gateway configuration folder on the Horizon Connection Server host.

    For example: install_directory\Omnissa\Horizon\Server\sslgateway\conf\locked.properties

  2. Add the balancedHost property and set it to the address of the load balancer.

    For example, if users type https://horizon.example.com in a browser to reach any of the load-balanced Horizon Connection Servers, add balancedHost=horizon.example.com to the locked.properties file.

  3. Save the locked.properties file.

  4. Restart the Horizon Connection Server service to make your changes take effect.

Was this page helpful?

Provide feedback for this topic

Was this topic helpful?

Please do not include any personal or confidential information.

Generating link…