Skip to main content

On-Premises preparation

For a TOPdesk environment that is hosted on-premises, we offer our Virtual Appliance solution. Before you install the TOPdesk Virtual Appliance, there are some things you will need to set up and arrange. You will find a detailed explanation of these things below.

We recommend to provide access to the My TOPdesk customer portal for colleagues that will be involved when installing the Virtual Appliance. We refer to knowledge items for instructions and help. Only contact persons that already have access to My TOPdesk are able to create accounts for colleagues. To create new accounts, read KI 6241 on My TOPdesk for instructions.

To make sure you get the best results, all people involved in this process should be familiar with most terminology and installation steps before the installation starts. A starting point to become familiar with Virtual Appliance concepts is found in KI 10568.


  • One of the following hypervisors (with the type of file behind it):

    • VMware Workstation Player / Pro (VMX/VMDK file)

    • VMware vSphere (OVA file)

    • Microsoft Hyper-V (VHDX file for the hard disk/XML file to install the virtual machine via VMCX/VMGS/VMRS files)

  • Download the Virtual Appliance itself via My TOPdesk. The download page lists checksum hashes in MD5 and SHA1 formats. This allows you to verify the downloaded file integrity. On Windows, you can do this with the command certutil -hashfile <filename> MD5 or certutil -hashfile <filename> SHA1. In Linux, use the command md5sum <filename>.

  • A Windows file share, and a Windows account which has access and can reach the file share.

  • A password for the Virtual Appliance—consisting of at least 8 characters—and a way to store it. Please note that the password can't be a word from the English dictionary.

  • PEM certificates (see KI 10568, part 2.4, on My TOPdesk) to setup encrypted TLS connections.

  • IP addresses for the local Network Time Protocol (NTP) server, in case an alternative to the default CentOS NTP server is to be used.

  • Windows user with DBO permissions on the TOPdesk database, if integrated security is desired.