> 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/use-devolutions-gateway-with-an-external-browser.md).

# Use Devolutions Gateway with an external browser

It is possible to use Devolutions Gateway with an external browser, but at the moment there are a few limitations to be aware of because of the browser design:

* It only works with Google Chrome.
* Google Chrome must be closed when opening a website from Remote Desktop Manager. A solution to this can be found in the [workaround](https://docs.devolutions.net/gateway/kb/how-to-articles/use-dgw-external-browser/#workaround-to-set-up-without-having-to-close-chrome).
* In case there are other proxy settings with Chrome (by GPO, command line, settings, etc.), they might conflict with each other and Devolutions Gateway will not work.
* In case Google Chrome is closed and does not have any other proxy settings, set up the entry to open externally like any other entries in Remote Desktop Manager. No additional installations/addons are needed for this to work.

### Workaround to set up without having to close Chrome

1. Right-click to go into the ***Properties*** of the ***Web Browser*** entry that has the Devolutions Gateway set.
2. In the ***General*** section, set the ***Display*** to ***External***.

   ![](https://cdnweb.devolutions.net/docs/docs_en_kb_KB0019.png)
3. Go to the ***Advanced*** tab.

   ![](https://cdnweb.devolutions.net/docs/docs_en_kb_KB0020.png)
4. Check ***User data path***.

   ![](https://cdnweb.devolutions.net/docs/docs_en_kb_KB0021.png)
5. Enter a path for a new Chrome user data to be stored.
6. Click ***Ok*** to save the changes.

### PowerShell

This section will showcase multiple solutions by using PowerShell.

#### Batch edit using PowerShell

It is possible to [batch edit](https://docs.devolutions.net/rdm/commands/edit/batch-edit/) the entries with a custom PowerShell command to make all of them use a different path (can be the temp or any place users are allowed to use it):

```powershell
$connection.Web.UseUserDataPath = $true;
$connection.Web.UserDataPath  = "C:\MyPath\" + $connection.ID;
$RDM.Save();
```

#### Temporary edit with Before open

It is also possible to [temporarily use the properties](https://docs.devolutions.net/rdm/kb/how-to-articles/execute-powershell-connection) 'Web.UseUserDataPath' set to true and 'Web.UserDataPath' set the path to the temp or any place users are allowed to use it that can be dynamic with a Before open event (using PowerShell Script).

```powershell
$RDM.Connection.Web.UseUserDataPath = $true
$RDM.Connection.Web.UserDataPath = "C:\MyPath\" + $RDM.Connection.ID
```

#### Deleting the folder

This code is used to delete the folder on the onClose Event:

```powershell
$connectionID = $RDM.Connection.ID
Remove-Item -Path "C:\MyPath\$connectionID" -Recurse -Force
```

{% hint style="info" %}
It is not possible to open a website using the Devolutions Gateway that is already running without the workarounds because of the way Google Chrome is designed. An already opened Chrome cannot change the proxy settings dynamically.
{% endhint %}


---

# 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/use-devolutions-gateway-with-an-external-browser.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.
