> 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 terminal sessions from a browser through the Devolutions Server or Cloud web interface using Devolutions Gateway.

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](/gateway/getting-started/devolutions-server/devolutions-gateway-configuration-with-devolutions-server.md) version 2023.1 or later.
* [Devolutions Server](https://docs.devolutions.net/server/getting-started/installation/devolutions-server-upgrade) version 2023.1 or later.
* An [SSH terminal session](https://docs.devolutions.net/rdm/knowledge-base/knowledge-base-articles/entry-settings/ssh-terminal) 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)](/gateway/knowledge-base/how-to-articles/launch-an-rdp-session-in-a-web-client.md)
* 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/vaults/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.
3. In the ***Connect*** drop-down menu, select ***Always connect***.
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.
5. Once all the conditions are met, you can press the ***Open in web client*** button.

### See also

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


---

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