The purpose of this document is to aid Apporto customers in setting up on-premises installations of Apporto NextGen software. Please review the section on known issues before beginning deployment.

Introduction

Apporto NextGen virtual desktop software is available for deployment to both cloud and on-premises environments. In both cases, the control plane is hosted in the cloud, making Apporto a hybrid system. This document details how an on-premises customer can connect their infrastructure to Apporto.

Product description

On-premises deployment of Apporto NextGen involves the following:

Apporto appliance cluster
This Kubernetes cluster converts standard Remote Desktop Protocol (RDP) traffic to Apporto’s Hyperstream. It consists of three (3) nodes deployed as virtual appliances.
Gateway or load balancer
This appliance sits in front of the appliance cluster, provides secure remote access for external users over https, and balances loads across Apporto node connections. You may use either the Apporto-provided secure gateway or your own preferred load balancer or content delivery controller.

Customer support

To submit a support request, visit https://www.apporto.com/support .

To access product help documentation, visit https://www.apporto.com/help-center/accessing-apporto-nextgen# .

Version info

Latest software version

apporto nextgen 2025.3

Updates in this version

Troubleshooting

System updates

Onboarding checklist

Use the list below to ensure that all mandatory steps are completed for your on-premises setup of Apporto NextGen.

Stage	Steps	Guide section
Ensure prerequisites are met	Review prerequisites for server hardware, network requirements, operating systems, and hypervisor versions. Gather information on the items above for entry into form fields and configuration settings.	Prerequisites
Determine architecture	Decide the number of manager, mixed, and worker nodes you will include in your cluster. Allocate resources for database, application, and gateway components.	Infrastructure
Review the deployment process	Sign in to the control plane and familiarize yourself with its contents. Verify that you are seeing all administrative sections you will need to configure. If additional team members will be assisting with deployment, create local admin accounts for them. Review the deployment process diagram to understand the steps that take place within the control plane, the on-prem tool, and your own environment.	Administration User management Deployment
Begin cluster setup in the Apporto control plane	Read the instructions in Step 1 of cluster installation wizard. Download the appropriate image file for your hypervisor.	Running the on-prem cluster install wizard
Install the Apporto on-prem VM into your hypervisor	Install the image file into your hypervisor. Run the included on-prem tool on the manager node for your cluster. Follow the instructions for your selected hypervisor.	Nutanix Prism configuration VMware vSphere configuration Proxmox Virtual Environment configuration
Complete cluster setup in the Apporto control plane	Complete Step 2 through Step 5 of the cluster installation wizard in the control plane. Verify that the cluster shows a successful installation status in the cluster list.	Running the on-prem cluster install wizard
Add a gateway or load balancer	Configure your existing or new gateway/load balancer. If you need to use Apporto’s secure gateway, follow the instructions in the article.	Adding a gateway or load balancer
Troubleshoot any issues	Review the articles on troubleshooting and known issues. Run diagnostic tests for any network issues. Enable the support tunnel if assistance is needed from Apporto Support.	Troubleshooting Setting up the support tunnel Known issues
Check for system updates	Load the on-prem tool in your manager node, and check to see if there are any Apporto appliance or node OS updates. Download and install updates to bring you up to the latest versions.	System updates
Complete resource configuration	Go to the Resource Hubs section of the control plane to finish configuring your cluster’s related resource hub. Create pools (farms) for servers and VMs Create servers and VMs. Create desktop pools.	Resources
Set up virtual desktops and applications	Create virtual desktops and apps. Configure license limits.	Desktop provisioning
Configure design and functional preferences	Configure branding and design elements. Configure authentication methods for control plane access as well as entry into virtual desktops/apps. Adjust email templates for system notifications. Enable and disable virtual desktop features for your instance.	Setup
Thoroughly test your instance	Gather your UAT team. Verify configuration settings throughout the control plane. Launch virtual desktops/apps. Use troubleshooting tools or contact Apporto Support for issues.
Add users to the system	Create user groups. Run the user import tool or turn on AD sync to add users en masse. Confirm that new users can sign in to the control plane.	User management

Apporto NextGen On-Premises Deployment Guide

Introduction

Product description

Customer support

Version info

Onboarding checklist

On this page

Related documents