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

Welcome to the official Apporto NextGen on-premises onboarding journey. This guide is the starting point for planning, deploying, validating, and preparing your hybrid Apporto environment for production use. Follow the sections in order to connect your on-premises infrastructure to the Apporto cloud control plane with a clear path from prerequisites through go-live readiness.

Welcome and support

We are glad to partner with you on your Apporto NextGen deployment. If you have questions during onboarding or need help validating your environment, contact Apporto Support at https://www.apporto.com/support.

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 four (4) nodes deployed as virtual appliances.
HAProxy 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. Customer will need to provide an HAProxy configuration or your own preferred load balancer or content delivery controller. F5, Fortigate, Progress'Kemp'LoadMaster as other supported solutions.

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# .

Onboarding checklist

Use this checklist to move through onboarding in the recommended order. Each guide link points to a published page.

Stage	Steps	Published guide

Stage	Steps	Published guide
Confirm prerequisites	Review required hardware, network, operating system, and hypervisor versions. Collect the values needed for setup forms and configuration fields.	Prerequisites
Design the architecture	Confirm manager, mixed, and worker node counts. Allocate resources for database, application, and gateway components.	Infrastructure
Review the deployment flow	Sign in to the control plane and confirm required administrative access. Create local admin accounts for deployment team members, if needed. Review the deployment process across the control plane, on-prem tool, and customer environment.	Administration User management Deployment
Start cluster setup	Complete Step 1 of the cluster installation wizard. Download the image file for your hypervisor.	Running the on-prem cluster install wizard
Install the on-prem VM	Install the Apporto image in your hypervisor. Run the on-prem tool on the manager node. Follow the instructions for your selected hypervisor.	Nutanix Prism configuration VMware vSphere configuration Proxmox Virtual Environment configuration
Complete cluster setup	Complete Steps 2 through 5 of the cluster installation wizard. Verify that the cluster shows a successful installation status.	Running the on-prem cluster install wizard
Add the gateway or load balancer	Configure HAProxy or your preferred load balancer.	HAProxy On‑Prem Setup and Configuration Guide
Check for system updates	Use the on-prem tool on the manager node to check for Apporto appliance and node OS updates. Install available updates before continuing configuration.	System updates
Configure resources	Finish configuring the related resource hub. Create pools, servers, VMs, and desktop pools.	Resources
Configure desktops, apps, and preferences	Create virtual desktops and applications. Configure license limits, branding, authentication, notifications, and feature settings.	Desktop provisioning Setup
Add and sync users	Create user groups. Run the user import tool or enable AD sync. Confirm users can sign in. Note: Users may authenticate successfully before the visible user count increments in the control plane.	User management
Test and troubleshoot	Run UAT with representative users. Verify configuration, launch desktops and apps, and resolve issues before go-live. Use diagnostic tools or contact Apporto Support if assistance is needed.	Troubleshooting Setting up the support tunnel Known issues

Go-Live Readiness

Your environment is ready for go-live when the cluster is installed successfully, gateway or load balancer access is working, required resources and applications are configured, user authentication has been validated, and representative users can launch desktops or apps during UAT.

All checklist stages are complete and linked guides have been reviewed.
Users can authenticate and access assigned resources. During user sync, users may authenticate successfully before the visible user count increments in the control plane.
Monitoring, troubleshooting, and support paths are understood by the deployment team.
Open issues have an owner, priority, and resolution plan before production launch.

Apporto NextGen On-Premises Deployment Guide