Troubleshooting Devolutions Gateway

This topic covers tips about troubleshooting Devolutions Gateway across multiple products.

Verify a gateway's health

It is possible to check if a particular gateway is alive and healthy.

  1. Open a web browser.

  2. In the address bar type https://<gateway.url>:<external port>/jet/health.

    Depending on the setup, it could also be `http`.

  3. Press Enter.

    Health check
    Health check

Devolutions Gateway Logs and diagnostics

If you are having trouble with a gateway, these solutions can make it easier to find more apparent errors.

  1. In the Devolutions Server web UI, go to AdministrationDevolutions Gateway.

  2. Click More on the desired gateway.

    More button
    More button
  3. Choose between Logs or Diagnostics.

Devolutions Gateway Logs

  1. Click on Logs.

    Logs
    Logs
  2. Observe the logs.

    Logs window
    Logs window

Devolutions Gateway Diagnostics

  1. Click on Diagnostics.

    Diagnostics
    Diagnostics
  2. Observe the statuses.

    Gateway status
    Gateway status

Service fails to start

If the service does not start at all, verify whether a file named boot.stacktrace exists in the same directory as the gateway.json configuration file. This file may contain relevant diagnostic information. Contact our support team if you are not able to identify the cause of the failure.

Certificate compatibility

Issues related to self-signed certificates missing a SAN or an EKU can be resolved by updating to the latest version of Devolutions Gateway.

It is recommended to set the TlsVerifyStrict option as true whenever possible. You should also configure this option if you encounter certificate issues on macOS and Chrome.

Devolutions Forum logo Give us Feedback