> 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/how-to-articles/launch-an-ssh-session-in-a-web-client.md).

# Launch an SSH session in a web client

Launch SSH session directly from your favorite web browser via the Devolutions Server or Devolutions Cloud web interface.

### Requirements

To use this feature, certain requirements must be met, namely:

* Windows 10 or 11.
* [Devolutions Gateway](https://docs.devolutions.net/gateway/getting-started/server/server-configuration/) version 2023.1 or later.
* [Devolutions Server](https://docs.devolutions.net/server/getting-started/installation/upgrade-server/) version 2023.1 or later.
* An [SSH terminal session](https://docs.devolutions.net/rdm/kb/knowledge-base/entry-settings/ssh-session-entry/) entry with a Devolutions Gateway VPN type configured must be created.
* A Remote Desktop Manager or Devolutions Launcher license must be assigned to the user launching the session.

### Supported session entries

Other session types can be launched via the Devolutions Server web interface:

* Active Directory
* Apple Remote Desktop (ARD)
* PowerShell (remote)
* [RDP (Microsoft Remote Desktop)](https://docs.devolutions.net/gateway/kb/how-to-articles/launch-rdp-session-web-client/)
* SSH terminal
* Telnet
* VNC

### SSH terminal session configuration

Follow the steps below to properly configure your SSH terminal session to launch it in a browser:

{% hint style="info" %}
The steps below assume that you already have an SSH terminal session entry. If you have not yet created it and want to learn how, see [Create entries manually](https://docs.devolutions.net/server/web-interface/vault/entries/create-entries-manually/).
{% endhint %}

1. In the Devolutions Server web interface, go to the ***Properties...*** of your SSH terminal entry.
2. In the ***VPN/Tunnel/Gateway*** section, select ***Devolutions Gateway*** in the ***VPN type*** drop-down list.

<figure><img src="https://cdnweb.devolutions.net/docs/DVLS4191_2025_1.png" alt=""><figcaption></figcaption></figure>

3. In the ***Connect*** drop-down menu, select ***Always connect***.

<figure><img src="https://cdnweb.devolutions.net/docs/DVLS4192_2025_1.png" alt=""><figcaption></figcaption></figure>

4. Under ***Settings***, select the Gateway to use for this connection, then click on ***Check health*** to make sure the Gateway is functional. Its version must be 2023.1 or later for this to work. Click on ***Update*** to save your changes.

<figure><img src="https://cdnweb.devolutions.net/docs/DVLS4193_2025_1.png" alt=""><figcaption></figcaption></figure>

5. Once all the conditions are met, you can press the ***Open in web client*** button.

![](https://cdnweb.devolutions.net/docs/DVLS4194_2025_1.png)

### See also

* [Launch an RDP session in a web client](https://docs.devolutions.net/gateway/kb/how-to-articles/launch-rdp-session-web-client/)
* [SSH terminal entry options](https://docs.devolutions.net/rdm/kb/knowledge-base/entry-settings/ssh-session-entry/)


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.devolutions.net/gateway/knowledge-base/how-to-articles/launch-an-ssh-session-in-a-web-client.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
