Introduction

Overview

With Thincast Workstation you can turn your computer into a powerful virtualization platform and share virtualized desktops with your team, while keeping the data centralized.

Thincast Workstation is currently in beta phase. See "Versions" below.

How does Thincast Workstation relate to VirtualBox?

The virtualization system of Thincast Workstation and the graphical user interface are derived from the VirtualBox Open Source Edition.
We've added a bunch of new features and devices, so there may be some differences between the usage and configuration of Thincast Workstation and VirtualBox. The VirtualBox end-user documentation can be found here. All differences will be covered in this user manual.

Versions

We provide different versions:

• Stable - Official releases. Use this for production.
• Beta - Upcoming releases. Beta versions are under qualification testing, and may include significant issues.
• Nightly - Development snapshot. Contains the latest features and improvements but isn't completely tested and may include severe issues.

The beta and nightly versions are mainly for preview and evaluation purposes. Don't use them in production!

It is the end users' responsibility to protect their systems and data when using beta or nightly software. We strongly recommend that end users back up all their data prior to using beta or nightly software.

Beta and nightly software does not carry any warranties or support services.

Requirements

Hosts that run Thincast Workstation must meet specific system requirements:

Host System

Supported Host Operating Systems

Thincast Workstation Beta requires a 64-bit Windows operating system with the latest Service Packs installed:

• Windows 10
• Windows Server 2016 / 2019

*: Please be aware when Microsoft Hyper-V role is installed on a Windows Server 2016 or 2019, no other virtualization solution will work because Hyper-V exclusively uses the hardware virtualization layer feature, VT-D!

Architecture

The host system must have a 64-bit Intel or AMD processor with 2.2 GHz or faster core speed. Multiprocessor systems are supported.

Memory and Storage

The minimum memory required on the host system is 2 GB, but 4 GB and above is recommended. Thincast Workstation needs at least 300 MB of available disk space for the application. We recommend that you use an SSD hard drive for storing your virtual machines.

Graphics Cards

Thincast Workstation provides full DirectX 11.2 support inside the guest operating system. This allows you to use your 3D applications with the same smooth and visual experience as running them on physical hardware.

In order to use hardware acceleration inside the VM, your graphics card must support at least DirectX 11. Please note that the GPU software drivers must support DirectX 11 Feature Level 11.0. The following list shows supported GPUs but is subject to driver support for your operating system:

• AMD® Radeon HD 5000 series or higher
• Nvidia® GeForce 400 series or higher
• Intel® HD Graphics 4000 or higher

If your hardware doesn't meet these requirements, you can still run and use your VMs. Thincast Workstation will simply fall back to use software drawing for graphics operations. However, please note that this results in a much lower performance and you might be unable to run certain applications in the guest.

To improve performance for remotely accessed VMs, Thincast Workstation can offload encoding of the remote display stream to the graphics card. The following graphics cards are supported:

• AMD® Radeon HD 7000 series (with AMF support) or higher
• Nvidia® GeForce 600/700 series (with NVENC support) or higher
• Intel® HD Graphics 4200/Haswell processors or higher

The latest graphics card drivers on the host system are required!

Please note: Do not update your host's GPU driver or disable the GPU in your host's device manager while a guest machine is running on Thincast Workstation. This will cause the guest to crash.

Network

Thincast Workstation requires a properly configured network to communicate with the Thincast Client. You can use any ethernet controller that the host system supports. Overall bandwidth consumption depends on the number of connected users, used applications, screen size and frame rates.

The values in the following list will give you an approximate reference point for a single user running resource-intensive applications such as games, 3D applications or watching a UHD movie:

Screen size	Frame rate	approx. bandwidth consumption
2160p (4k)	30 frames	40 Mbps
1440p (2k)	30 frames	10 Mbps
1080p	30 frames	8 Mbps
720p	30 frames	5 Mbps
480p	30 frames	2.5 Mbps
360p	30 frames	1 Mbps

Virtual Machine

Supported Guest Operating Systems

A full list of supported guest operating systems can be found here. Please note, although all these operating systems are supported, Guest Additions are not available for all of them.

Installation

Prerequisites

Thincast Workstation supports Windows 64-bit operating systems. For more details please refer to Supported Host operating systems. Please also make sure that you have the latest Windows updates and drivers installed.

Installing Thincast Workstation

1. To download the latest version of Thincast Workstation, please visit our website and go to the product page of Thincast Workstation.
2. Open the installation package. Setup requires administrative rights.
3. Accept the end-user license agreement and click "Next".
4. Choose the destination folder for Thincast Workstation and click "Next".
5. Select the features you want to install.
6. Select the port you want Thincast Remote Desktop WebServices to use (default is 443).
7. Enable or disable the shortcuts and click "Next".
8. To proceed with the installation, click "Yes" Please be aware that you will get temporarily disconnected from the network if you selected the network feature.
9. Click install to begin the installation.
10. Click finish to complete your installation.
11. Congratulations! You have successfully installed Thincast Workstation.

Uninstallation

1. To uninstall Thincast Workstation, open the Windows Control Panel and navigate to Programs -> Uninstall a program.
2. Right-click on Thincast Workstation and select Uninstall.
3. Confirm with Yes.
4. You've now successfully uninstalled Thincast Workstation.

Configuration

Because Thincast Workstation is based on VirtualBox's virtualization system, most of the configuration is already covered in the VirtualBox end-user documentation which can be found here. All additional settings and configuration options that are introduced in Thincast Workstation will be covered in the following sections.

Global Settings

You can find the global settings dialog by clicking on File -> Preferences in the Thincast Workstation Manager.

General

Default Machine Folder

The default file system location for storing virtual machines is C:\ProgramData\Thincast VMs

VRDP Certificate

To verify your server's authenticity, a digital certificate file is used. By default, we create a self-signed certificate during the installation which is valid for 10 years. You can also use a custom certificate which is distributed by a certificate authority (CA).

VRDP Private Key

Specifies the private key file. This must be the private key file associated with the VRDP Certificate.

VRDP Start Port

Specifies the start port of the VRDP server. Every virtual machine gets an individual port assigned.

Input

Specifies the shortcuts for most common tasks in Thincast Workstation.

Updates

Thincast Workstation has an automatic update feature. You'll get a notification when a new version of Thincast Workstation is available. Automatic updates can be enabled or disabled here.

You can also switch between the available update channels for Thincast Workstation:

• Stable releases

  Choose this if you wish only to be notified about stable updates to Thincast Workstation.

• Stable and beta releases

  Choose this to be notified about stable and beta updates to Thincast Workstation.

• Stable, beta and nightly releases

  Choose this to be notified about stable, beta and nightly updates to Thincast Workstation. Note: Nightly updates might be unstable!

Extensions

Thincast Workstation includes two default extensions:

• "TcXhci" - USB 3.0 Controller
• "Virtual3D" - Hardware-accelerated graphics in the virtual machines (supporting DirectX 9 - 11.2, hardware video decoding) and Thincast HD Audio

Creating Virtual Machines

The creation of virtual machines is the same as in VirtualBox. Please refer to the VirtualBox user manual chapter 1.7, Creating your first virtual machine.

Configuring Virtual Machines

To configure your virtual machine, click on "Settings" after you have selected a specific virtual machine.

General

Advanced

Thincast Workstation contains an advanced shared clipboard that also works with files. By default, the shared clipboard operates in bidirectional mode. Drag'n'Drop support is not available.

Display

Screen

GPU - Assign a GPU to a specific virtual machine

To use DirectX and hardware video decoding, a VM must be assigned to a specific GPU. Depending on the selected GPU, H.264 encoding can be fully or partly accelerated. If the GPU does not support H.264 encoding, software encoding will be used instead.

For more information please refer to the section Graphics cards.

Force Software H.264 encoding - If checked, the virtual machine will use software H.264 encoding.

Force V-Sync on Remote Displays - If checked, the frame rate for remote displays will be limited to 30 frames/second.

Remote Display

Remote Displays are enabled on Thincast Workstation by default. Remotely connected clients access the machine via the Remote Display.

Audio

Thincast HD Audio - If Thincast HD Audio as Audio Controller is selected, remote and local HD audio playback is enabled.

USB

USB 3.0 device redirection through the TcXhci USB Controller is enabled by default.

Thincast Guest Additions

Our guest additions contain drivers and applications that enable DirectX, audio and clipboard support in the guest operating system.

These guest additions can only be installed after the guest operating system has been installed.

The following x86/x64 Windows guest operating systems are supported:

• Windows 7 / 8 / 8.1 / 10
• Windows Server 2008 R2 / 2012 / 2012 R2 / 2012 / 2016

Virtual 3D (Direct X)

We have redesigned the graphical subsystem to provide full DirectX and hardware video decoding (Direct3D11 Video/DXVA 2) support in the virtual machines.

Thincast Workstation currently supports up to DirectX 11.2 and WDDM (Windows Display Driver Model) 1.3. DirectX 12 and WDDM 2.0 support is in the making.

USB 3.0 Device Redirection

Any USB device that is physically attached to the host can be redirected to the virtual machine. Take advantage of high-speed USB 3.0 devices in your virtualized desktops.

Unfortunately, Windows 7 and Windows Server 2008 R2 do not have built-in support for USB 3.0. Installing a third-party USB 3.0 controller driver in the guest operating system will solve this issue:

Intel® USB 3.0 eXtensible Host Controller Driver for Intel® 8/9/100 Series

Audio Playback

The Thincast HD Audio device enables guest audio playback. It also supports audio playback for remotely connected clients.

Install Thincast Guest Additions

1. To install Thincast Guest Additions, connect to a virtual machine.
2. In the menu bar of Thincast Viewer, click on "Devices" and select "Install Guest Additions" to mount the Guest Additions image file inside your VM.
3. Double-click on the inserted disc in your VM -> This PC.
4. Accept with "Yes" to proceed with the installation.
5. The Thincast Guest Additions Setup Wizard will open. Click "Next" to proceed.
6. Click "Next" to install Thincast Guest Additions in the default folder.
7. Click "Install" to install Thincast Guest Additions.
8. Select "Reboot now" and click "Finish" to complete the installation of Thincast Guest Additions.
9. Your VM will reboot and the Thincast Guest Additions installation will be complete.

Windows Authentication

The access to virtual machines running on Thincast Workstation is secured by Windows Authentication. By default, administrators of the host machine have complete and unrestricted access to Thincast Workstation VMs. You can add additional users to the "Thincast Workstation Admins" group to grant them access to Thincast Workstation VMs.

Thincast Agent

The Thincast Agent service provides access to various functions of Thincast Workstation to connected clients. All Thincast Clients that connect to Thincast Agent have to authenticate using Windows Authentication. For more information about authentication, refer to Windows Authentication.

The Thincast Agent service must be running for Thincast Workstation to function properly.

Thincast RD WebServices Lite

Thincast Remote Desktop WebServices Lite (RD WebServices Lite) is a collection of technologies that allow you to easily access your virtual machines from anywhere. With Thincast Remote Desktop WebAccess (RD WebAccess) you gain access to a portal to control and connect to all your virtual machines using Thincast Client or any web browser. Connections to your VM are secure and can be established from any device using Thincast Remote Desktop Gateway (RD Gateway).

Configuration

Thincast RD WebServieces can be configured using the RD WebServices Lite Administration application that is located in C:/Program Files/Thincast/Workstation/RDWebServices/adminworkstation.exe. This chapter describes how to configure RD WebServices Lite and its components for use.

First, open RD WebServices Lite Administration and connect to the machine on which RD WebServices Lite is running. The user account must be a member of the local Administrator group. You also have the ability to save the credentials (not recommended).

Settings

In the settings pane, you can configure the default server port and view information about the machine running RD WebServices.

Change default port

The default server port is 443. Sometimes it is necessary to change this e.g., when you already have another service using this port:

1. Type in the port number.
2. Click on "Save" and confirm to restart the service.

Certificate

To establish a secure connection between the RD WebAccess and the end user, both a private key and a public key are required to encrypt the connection. These keys are included in the certificates.

You can obtain a certificate in several ways:

• Upload an existing certificate
• Create a self-signed certificate
• Purchase a certificate from a certification authority (CA)

For testing and evaluation purposes we recommended that you use a self-signed certificate.

Upload an existing certificate

This chapter describes how to upload an existing certificate in the .pem/.pfx format:

1. To upload/import an existing certificate, please click on Upload pem/pfx certificate and approve the notification by clicking "OK".
2. Now select your existing certificate by navigating to the folder in which the certificate has been saved. The certificate must be in .pem or .pfx format.
3. Upload your certificate by clicking "Open".
4. If you use a certificate in pfx format, a password is required.
5. Approve the notification dialogue by clicking "OK". The certificate has now been uploaded and installed.

Create a self-signed certificate

This chapter describes how to create a self-signed certificate.

You must specify a hostname, which the RDP client uses to connect to the RDP WebServices server.

Production environment:

For production usage, you should use the complete domain name of your server, also known as the Full Qualified Domain Name (FQDN).

The FQDN consists of two parts: the hostname and the domain name. For example, an FQDN for a hypothetical test server might be testserver.mycompany.com. The hostname is testserver, and the host is located within the domain mycompany.com.

Testing environment:

For testing purposes you can also use the internal hostname or the IP address (NetBIOS, FQDN or IP address).

1. Click on Create self-signed certificate.
2. Enter the "Hostname," which the RDP client uses to connect to the RD WebServices Lite server.
3. Click on "OK".
4. A new self-signed certificate is now installed. It can be found in the installation path of RD WebServices Lite.

Download certificate

To establish the SSL session with the server, the client needs to validate the server's certificate. Therefore, the client must have the certificate installed in its "Trusted Root Certificate Store".

How to obtain a certificate for the client computer:

1. Click on Download certificate.
2. Please select the path where RD WebServices Lite should save the client certificate. The certificate will be saved in the .crt format.
3. Import this certificate into your client's certificate store.

Client Connection Settings

In the client connection settings pane you can control how the RDP connection data for the client is generated by RD WebServices Lite.

Hostname/Ip

This setting allows you to configure the target where the client will establish its connections. This can be helpful if you have multiple network interfaces. You can either select from a list of available addresses or you can specify a custom name that is resolvable with a DNS.

Use RD Gateway

If you enable this switch, RD WebServices Lite will generate client connection parameters so that connections are established using RD Gateway.

Advanced Settings

Authentication cookie

A sha256 key is used in cookie generation.

When load balancing is used to access RD WebAccess, the servers should share the same key so that the authentication cookie works for both servers, or if any cookies should be revoked forcing all users to reauthenticate, the simplest way would be to change the key.

Thincast Client

Thincast Client allows you to access and manage all your virtualized desktops running on Thincast Workstation. It is completely free and currently available for Windows, MacOS and Linux. To install the Thincast Client, refer to the Thincast Client - User manual.

Thincast Client can be used on different machines in your network and works independently of Thincast Workstation.

Please refer to the Thincast Client - User manual for further details.

Support

Please keep in mind that Thincast Client beta and nightly builds do not carry any warranties or support services.

However, we are eager to hear about your experiences and any troubles with Thincast Client beta! Please let us know by filling out our contact form.

Changelog

The changelog can be found on our website.

Third-party licenses

Thincast Workstation is based on Oracle's VirtualBox - Open Source Edition.

Open-source software licenses used in this project are located under C:\Program Files\Thincast\Workstation\Licenses\COPYING.html