> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/gateway/knowledge-base/troubleshooting-articles/devolutions-gateway-troubleshooting.md).

# Devolutions Gateway troubleshooting

Troubleshoot Devolutions Gateway by checking gateway health, reviewing logs and diagnostics, and resolving certificate or proxy issues.

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

{% hint style="info" %}
If you are unable to download the logs from the web, you can also find them in the installation folder: `C:\ProgramData\Devolutions\Gateway`.
{% endhint %}

### Verify the health of a gateway

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 <kbd>Enter</kbd>.

### 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 ***Administration*** – ***Devolutions Gateway***.
2. Click ***More*** on the desired gateway.
3. Choose between ***Logs*** or ***Diagnostics***.

#### Devolutions Gateway logs

1. Click on ***Logs***.
2. Observe the logs.

#### Devolutions Gateway diagnostics

1. Click on ***Diagnostics***.
2. Observe the statuses.

### 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](mailto:service@devolutions.net) 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.

### Connection to the server lost

If you receive this error message, make sure that the service account configured on the Devolutions Gateway service can reach the recording destination folder and has the required permissions to create the recording folders and files.

### Proxy issues

If you experience problems loading or using web entries in Remote Desktop Manager when Devolutions Gateway is configured as a proxy, check the log files for additional details:

* Windows path: `C:\Users\<user>\AppData\Roaming\jetsocat`
* macOS path: `/Users/<user>/Library/Application Support/jetsocat`

If the issue persists, please contact our customer support team for assistance at <service@devolutions.net> and provide the relevant log files.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.devolutions.net/gateway/knowledge-base/troubleshooting-articles/devolutions-gateway-troubleshooting.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.