Introduction
This article only applies to you if you host your Clientless RDP gateway yourself. We recommend letting us host your gateway. If you are a partner looking to get started with Clientless RDP, please contact support.
In this article we describe the gateway requirements for v1.5 of our Clientless RDP application, and the information required before we can install it for you. This applies to both upgrades to an existing installation and new installations.
To check which version you are running:
Navigate to the CRDP URL.
If the version is not shown in the bottom right of the screen, press F12 to open your browsers Developer Tools console.
Make sure the 'Sources' tab is selected.
Expand the folder 'clientlessrdp' and then 'web jars'.
Here, you should be able to see what version you're running.
Clientless RDP v1.5 requirements
A new (virtual) server running Ubuntu 22.04 LTS.
Note: We do not support Ubuntu release upgrades, e.g. from 20.04 LTS to 22.04 LTS.
A user account with sudo rights.
Internet access.
Server Choice:
In case of a new server:
A Clientless RDP hostname (URL) that points to the external IP address of the server.
Incoming traffic allowed for TCP ports 80 and 443.
Outgoing traffic allowed to the RDS server(s).
If this is an installation to replace a server running an older version of CRDP:
The same network configuration and capabilities as the previous server.
A client machine with an internet browser to test the installation (and possibly transfer files between servers in case of a replacement installation).
(Virtual) Hardware requirements
CPU: 2 v-processor running at 2.0GHz or higher
Memory: 6GB of RAM or more
Storage: 50GB of storage or more
Note: if you are hosting the gateway in your own network we expect you to monitor CPU, memory and disk usage and resize if needed.
Software requirements
Ubuntu 22.04 LTS (we only support LTS versions)
Port forwarding
443
80
Public IP Addresses
1
Certificates (choose one option)
Automatic renewal via Let's Encrypt (Recommended)
If your gateway is hosted by us, we will ask you to create a CNAME record for the CRDP gateway URL to a URL in our domain.
Wildcard certificate or Single hostname certificate
If you host the gateway in your own network and you want to use a certificate file, we need it in PFX format and the password cannot contain any symbols.
Installation choices
Will this be a single server setup or a redundant setup?
Single server setup: do we use a local MySQL database (default) or an external MySQL or MS SQL database?
Redundant setup: do we use an external MySQL or MS SQL database?
If we need to transfer a local MySQL database to a new server, we will need the MySQL root password. If you do not have this password, it can be reset, but that will lead to downtime as the database needs to be stopped.
Should we be upgrading an external database, please make sure there is a usable backup available before the upgrade.
Useful data when performing an upgrade
The Clientless RDP administrator username.
The Workspace 365 URL to which you want to forward visitors of the root URL of the gateway.
Release notes
The latest version of our Clientless RDP application is version 1.5 (February 2024)
This version is only compatible with Ubuntu 22.04 LTS
Additions
Version tag on the login screen
Fixes
Fixed possible issues with RDP audio input
Improvements
Improved custom Dutch translation
Updated components to apply multiple security fixes and security improvements
Technical items
Optional support for lossless graphics compression
Additional notes
Our application window switch button (which offers remote alt-tab functionality) no longer supports Windows Server 2012 R2. We only support switching between open application windows with the switch button when connecting to servers running Windows Server 2016 and higher.
V1.3 (Februari 2021)
Additions
Automatic cleanup of Clientless RDP temporary storage. Temporary files during copy/paste operations are automatically cleaned up after 24 hours.
Fixes
Issue when caps lock was not working as expected.
Issue when some keyboard shortcuts were not working as expected.
Improvements
Reduced latency for RDP connections.
Optimized Web Socket performance.
Technical items
New and improved RDP mechanism.
Optimized memory management.
General security optimizations.