This topic describes how to configure Devolutions Server to connect with Devolutions Gateway. There are two ways to install a Devolutions Gateway: the Side-by-side Installation and the Standalone Installation.
Steps for Side-by-side Installation
To set up a free Devolutions Gateway, it must be installed using the Side-by-side configuration. It creates a gateway capable of handling up to 5 concurrent sessions.
This method supports more sessions if there is an available Devolutions Gateway license(s). This installation process is the easier of the two. However, this method is recommended for simpler network layouts, and only one Side-by-side installation can be done per machine.
- From the Devolutions Server Console, click on the Companions tab.
Companions Tab - In the Devolutions Gateway section, click on Install.
- Choose Side-by-side Installation.
Side-by-side
It is possible to download an .msi file to install Devolutions Gateway on an offline Devolutions Server.
- If default values don't work for your environment, enter the desired settings.
- HTTP Listener: HTTP(s) port to reach the Gateway. (7171 is default)
- TCP Listener: port used for the RDP sessions. (8181 is default)
- Click Ok.
Ok Button - Go to the Devolutions Server web interface, connect with an administrator account.
- Go to Administration – Devolutions Gateway.
Devolutions Gateway - Click on the Ping button for the desired gateway in the list to see if a connection can successfully be made. If the page was already open, refresh it first.
Ping
Steps for Standalone Installation
Installing by using the Standalone method will allow to install Devolutions Gateway on a separate server than Devolutions Server. It could be for performance purposes or access networks that Devolutions Server can't access. Many Devolutions Gateway can be used by Devolutions Server, but only one Devolutions Gateway can be installed on a machine.
- From the Devolutions Server Console, click on the Companions tab.
Companions Tab - In the Devolutions Gateway section, click on Install.
- Choose Standalone Installation.
Standalone - Choose between Download version & Install from msi file.
It is possible to download an .msi file to install Devolutions Gateway on an offline Devolutions Server.
- Click Next.
Download version or msi file - Enter the Access URI information, for example https://gateway.example.com.
- Choose the Devolutions Gateway Listeners ports (by default they are 7171 and 8181).
- If HTTPS is chosen instead of HTTP in the step above, the Certificate Configuration will be needed.
- Certificate file: Needs to be a full chain certificate (.pfx, .p12, .pem, .crt).
- Certificate password: Only needed if a .pfx or .p12 certificate was used.
- Private key file: Only needed if a .pem or .crt was used as a certificate.
Do not share the private key with other users, as it can be used to decrypt the communication between a user and Devolutions Gateway. Only the public key should be shared.
- Click Next.
Listeners - Choose between:
- Use public key from DVLS instance 'Devolutions Server': this option is used if the installed Devolutions Gateway is on the same server as the Devolutions Server;
- From file: If installing Devolutions Gateway on another computer, download the public key from the Devolutions Server you want to pair with that Devolutions Gateway. It is located under Administration – Devolutions Gateway.
Download public key
- Click Next.
Key Pair Configuration - Click Install.
Summary - Click Close.
Installation Summary - On the Devolutions Server web interface, connect with an administrator account.
- Go to Administration – Devolutions Gateway.
Devolutions Gateway - Click on the Add button on the top right corner.
Add Button - Enter the following information.
- Name: Name of the gateway that will be displayed in Remote Desktop Manager.
- Description: Description of the gateway.
- Set as default: If enabled, this gateway will be selected by default when configuring Remote Desktop Manager.
- Devolutions Gateway URL: The Devolutions Server URL that the gateway will connect to.
- TCP Listening Port: Set the port with the same TCP port value configured in the console.
- Click on Save.
Devolutions Gateway Information
The gateway should now be visible in the list. It is possible to verify the status of the gateway with the Ping button.