Devolutions Gateway configuration with Devolutions Server

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.

Many gateways can be used by Devolutions Server, but only one Devolutions Gateway can be installed on a machine.

If your clients fail to connect with Devolutions Gateway, ensure the certificate contains the entire chain. This certificate chain includes any intermediate certificates. For example:

Root Certificate Authority – Secure Certificate Authority – Purchased XYZ Certificate

Differences between Side-by-side and Standalone installation

The Side-by-side installation will be used if you need to install Devolutions Gateway on the same machine where Devolutions Server is hosted. It is a simplified installation process that will automatically configure the new Devolutions Gateway with information from the Devolutions Server instance (access URI and public key).

To install Devolutions Gateway on another machine than the one where Devolutions Server is hosted, you need to follow the Standalone installation process. The procedure is similar, but you will need to provide more information about your Devolutions Server instance to complete it.

Side-by-side installation

This method supports more sessions if there is an available Devolutions Gateway license(s). This installation process is the easier of the two and is the recommended method for simpler network layouts.

  1. From the Devolutions Server Console, click on the Companions tab. Companions tab

  2. In the Devolutions Gateway section, click on Install.

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

  4. If default values do not 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)

  5. Click OK. OK Button

  6. Go to the Devolutions Server web interface, connect with an administrator account.

  7. Go to Administration – Devolutions Gateway.

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

Standalone installation

The Standalone method allows Devolutions Gateway to be installed on a separate server than Devolutions Server. It could be for performance purposes or access networks that Devolutions Server cannot access.

The Devolutions Server Console must be installed on the server on which Devolutions Gateway will be installed.

  1. From the Devolutions Server Console, click on the Companions tab. Companions Tab

  2. In the Devolutions Gateway section, click on Install.

  3. Choose Standalone Installation. Standalone

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

  5. Click Next. Download version or msi file

  6. Enter the Access URI information, for example https://gateway.example.com. Listeners

  7. Choose the Devolutions Gateway Listeners ports (by default they are 7171 and 8181). Devolutions Server will use the Access URI port (usually 443 or 7171) for health checks and initial configuration. Remote Desktop Manager will use ports 7171 and 8181 to connect to the Gateway. For instance, a web session using the Gateway will connect on port 7171, as will any registration via Devolutions Gateway. Port 8181 is used by sessions such as RDP.

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

  8. Click Next.

  9. Choose between:

    • Use public key from Devolutions Server 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

  10. Click Next. Key Pair Configuration

  11. Click Install. Summary

  12. Click Close. Installation Summary

  13. On the Devolutions Server web interface, connect with an administrator account.

  14. Go to Administration – Devolutions Gateway.

  15. Click on the Add button on the top right corner. Add Button

  16. 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 Gateway URL and Port that Devolutions Server will connect to, for example: https://gateway.example.com:7171.

    • TCP Listening Port: Set the port with the same TCP port value configured in the Devolutions Server Console.

  17. Click on Save. Information

The gateway should now be visible in the list. It is possible to verify the status of the gateway with the Ping button. Ping

See also

Devolutions Forum logo Give us Feedback