> 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/rdm/knowledge-base/knowledge-base-articles/entry-settings/openvpn.md).

# OpenVPN GUI

Configure OpenVPN GUI entries in Remote Desktop Manager, including custom or existing configurations, certificates, automatic authentication, and VPN settings.

This article details the many settings and options available for ***OpenVPN GUI*** VPN entries in Remote Desktop Manager.

{% hint style="info" %}
Automatic authentication uses simulated key presses to enter credentials for connections. Once the VPN is launched, do not press anything until the authentication completes or the timeout expires.
{% endhint %}

<table data-header-hidden><thead><tr><th width="200"></th><th></th></tr></thead><tbody><tr><td><strong>SETTINGS</strong></td><td><strong>DESCRIPTION</strong></td></tr><tr><td><strong>Name</strong></td><td>The name of the entry.</td></tr><tr><td><strong>Folder</strong></td><td>The folder where the entry is located.</td></tr><tr><td><strong>Display</strong></td><td>How the entry opens. VPN entries open as <em><strong>External</strong></em>, and the list cannot be changed. Additional lists let you choose the monitor and the virtual desktop where the window opens.</td></tr><tr><td><strong>Credentials</strong></td><td>How the credentials of the entry are provided. Select a credential mode from the list.</td></tr><tr><td><strong>VPN type</strong></td><td>The type of VPN of the entry. <em><strong>OpenVPN GUI</strong></em> is selected for this entry. Selecting another type replaces the settings of the <em><strong>Connection</strong></em> tab.</td></tr></tbody></table>

### Connection

The ***Connection*** tab holds three sub-tabs: ***General***, ***Login***, and ***Advanced***.

**General**

<table><thead><tr><th width="220">SETTINGS</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Configuration type</strong></td><td><p>Select where the OpenVPN configuration comes from:</p><ul><li><strong>Custom</strong> — the configuration is defined in the entry with the settings below.</li><li><strong>Existing</strong> — the entry uses an existing OpenVPN configuration file.</li></ul></td></tr><tr><td><strong>File</strong></td><td>The existing OpenVPN configuration file. Visible and required when <em><strong>Configuration type</strong></em> is set to <em><strong>Existing</strong></em>.</td></tr><tr><td><strong>Use as configuration file path</strong></td><td>Use the folder of the selected file as the OpenVPN GUI configuration folder, instead of the configuration folder defined in the application options. Visible when <em><strong>Configuration type</strong></em> is set to <em><strong>Existing</strong></em>.</td></tr><tr><td colspan="2">The settings below are visible when <em><strong>Configuration type</strong></em> is set to <em><strong>Custom</strong></em>.</td></tr><tr><td><strong>Host</strong></td><td>The list of servers of the configuration. Required. Use the <em><strong>Add</strong></em>, <em><strong>Edit</strong></em>, and <em><strong>Delete</strong></em> buttons to manage the list. Each server has a <em><strong>Host</strong></em>, a <em><strong>Server port</strong></em>, a <em><strong>Protocol</strong></em>, a <em><strong>Local port</strong></em>, <em><strong>Retry connection for</strong></em> (seconds), <em><strong>Max connection retries</strong></em>, <em><strong>No binding</strong></em>, <em><strong>Float (don’t bind to server IP)</strong></em>, and optional <em><strong>HTTP proxy</strong></em> and <em><strong>SOCKS proxy</strong></em> settings.</td></tr><tr><td><strong>Certificate file format</strong></td><td><p>Select how the certificates are provided:</p><ul><li><strong>Individual</strong> — separate <em><strong>CA Certificate</strong></em>, <em><strong>Client certificate</strong></em>, and <em><strong>Client Key</strong></em> files.</li><li><strong>PKCS12</strong> — a single <em><strong>PKCS #12 file</strong></em>.</li></ul></td></tr><tr><td><strong>Device</strong></td><td><p>Select the virtual network device type:</p><ul><li><strong>tap</strong></li><li><strong>tun</strong></li></ul></td></tr><tr><td><strong>Data ciphers</strong></td><td>Select one or more data ciphers from the list, or select <em><strong>All</strong></em>.</td></tr><tr><td><strong>Protocol</strong></td><td><p>Select the protocol of the connection:</p><ul><li><strong>tcp</strong></li><li><strong>udp</strong></li><li><strong>udp4</strong></li><li><strong>udp6</strong></li></ul></td></tr><tr><td><strong>CA Certificate</strong></td><td>The CA certificate file. Visible when <em><strong>Certificate file format</strong></em> is set to <em><strong>Individual</strong></em>.</td></tr><tr><td><strong>PKCS #12 file</strong></td><td>The PKCS #12 file. Visible when <em><strong>Certificate file format</strong></em> is set to <em><strong>PKCS12</strong></em>.</td></tr><tr><td><strong>Cipher</strong></td><td>Select the cipher from the list.</td></tr><tr><td><strong>Client certificate</strong></td><td>The client certificate file. Visible when <em><strong>Certificate file format</strong></em> is set to <em><strong>Individual</strong></em>.</td></tr><tr><td><strong>Auth Retry</strong></td><td><p>Select the authentication retry behavior:</p><ul><li><strong>none</strong></li><li><strong>nointeract</strong></li><li><strong>interact</strong></li></ul></td></tr><tr><td><strong>Client Key</strong></td><td>The client key file. Visible when <em><strong>Certificate file format</strong></em> is set to <em><strong>Individual</strong></em>.</td></tr><tr><td><strong>Logging</strong></td><td>Select the logging level, from 0 to 9.</td></tr><tr><td><strong>TLS Key</strong></td><td>The TLS authentication key file.</td></tr><tr><td><strong>TLS Key Type</strong></td><td><p>Select the TLS key type:</p><ul><li><strong>0</strong></li><li><strong>1</strong></li><li><strong>Default</strong></li></ul></td></tr><tr><td><strong>Use authentication</strong></td><td>Authenticate with a username and password.</td></tr><tr><td><strong>Random</strong></td><td>Connect to the servers of the list in a random order.</td></tr><tr><td><strong>No binding</strong></td><td>Do not bind to a local address and port.</td></tr><tr><td><strong>Check server type</strong></td><td>Check the certificate type of the server.</td></tr><tr><td><strong>Persist key</strong></td><td>Keep the keys across restarts of the connection.</td></tr><tr><td><strong>Persist tunnel</strong></td><td>Keep the tunnel device open across restarts of the connection.</td></tr><tr><td><strong>LZO Compression</strong></td><td>Use LZO compression.</td></tr><tr><td><strong>Explicit exit notification</strong></td><td>Notify the server when the connection closes.</td></tr><tr><td><strong>Use client mode</strong></td><td>Run OpenVPN in client mode. Checked by default.</td></tr><tr><td><strong>Import</strong></td><td>Import an OpenVPN configuration file into the entry.</td></tr><tr><td><strong>Export</strong></td><td>Export the configuration of the entry to a folder.</td></tr><tr><td><strong>Additional parameters</strong></td><td>Open the <em><strong>Additional configuration parameters</strong></em> window to enter parameters that are not supported by the options of the tab, one per line. Parameters an import does not recognize are added to this list.</td></tr></tbody></table>

**Login**

<table><thead><tr><th width="220">SETTINGS</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Enable automatic authentication</strong></td><td>Enter the username and password automatically when the VPN opens.</td></tr><tr><td><strong>Set authentication</strong></td><td>Enter the username and password used for automatic authentication. Available when <em><strong>Enable automatic authentication</strong></em> is checked and <em><strong>Credentials</strong></em> is set to <em><strong>Username and password</strong></em>.</td></tr><tr><td><strong>Use authentication file</strong></td><td>Provide the credentials through an authentication file instead of simulated key presses. Available when <em><strong>Enable automatic authentication</strong></em> is checked.</td></tr><tr><td><strong>Login window title</strong></td><td>The title of the OpenVPN GUI login window that receives the credentials. Check the box to enter a title. Available when <em><strong>Enable automatic authentication</strong></em> is checked and <em><strong>Use authentication file</strong></em> is cleared.</td></tr><tr><td><strong>Check save password box</strong></td><td>Check the save password box of the OpenVPN GUI login window. Available when <em><strong>Enable automatic authentication</strong></em> is checked and <em><strong>Use authentication file</strong></em> is cleared.</td></tr><tr><td><strong>Enable automatic key password entry</strong></td><td>Enter the key password automatically when the VPN opens.</td></tr><tr><td><strong>Set key password</strong></td><td>Enter the key password used for automatic key password entry. Available when <em><strong>Enable automatic key password entry</strong></em> is checked.</td></tr><tr><td><strong>Login window title</strong></td><td>The title of the window that receives the key password. Check the box to enter a title. Available when <em><strong>Enable automatic key password entry</strong></em> is checked.</td></tr><tr><td><strong>Automatic authentication timeout (seconds)</strong></td><td>The maximum time to wait for the login window, from 0 to 300 seconds. A value of 0 is saved as 10.</td></tr><tr><td><strong>Autofill delay (ms)</strong></td><td>The delay before the credentials are entered, from 0 to 10000 milliseconds.</td></tr></tbody></table>

**Advanced**

<table><thead><tr><th width="220">SETTINGS</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td colspan="2"><strong>OpenVPN GUI options</strong></td></tr><tr><td><strong>Clear log</strong></td><td>Clear the OpenVPN GUI log instead of appending to it.</td></tr><tr><td><strong>Hide connection status</strong></td><td>Hide the OpenVPN GUI connection status window.</td></tr><tr><td><strong>Show toast notifications</strong></td><td><p>Select when OpenVPN GUI shows notifications:</p><ul><li><strong>Never</strong></li><li><strong>At initial connect</strong></li><li><strong>At every reconnect</strong></li></ul></td></tr><tr><td><strong>Custom filename</strong></td><td>The name of the configuration file that Remote Desktop Manager creates for OpenVPN GUI. When empty, the host of the first server in the <em><strong>Host</strong></em> list is used. Saved only when <em><strong>Configuration type</strong></em> is set to <em><strong>Custom</strong></em>.</td></tr><tr><td colspan="2"><strong>Others</strong></td></tr><tr><td><strong>Kill existing sessions before connecting</strong></td><td>Close the running OpenVPN processes before opening the connection.</td></tr><tr><td><strong>Enable debugging</strong></td><td>Enable debugging for the connection.</td></tr></tbody></table>

### Advanced

<table><thead><tr><th width="220">SETTINGS</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td><strong>Go offline on connection</strong></td><td>Switch Remote Desktop Manager to offline mode when the VPN connects.</td></tr><tr><td><strong>Close connection after (min)</strong></td><td>Close the VPN automatically after the set number of minutes, from 0 to 4320.</td></tr><tr><td><strong>Detect reachable host in wait</strong></td><td>While waiting for the VPN, detect whether the host can already be reached.</td></tr><tr><td><strong>VPN reconnect mode</strong></td><td><p>Select the reconnect behavior of the VPN:</p><ul><li><strong>Default</strong></li><li><strong>Reconnect VPN</strong></li><li><strong>Leave VPN open</strong></li></ul></td></tr><tr><td><strong>Go online on disconnect after (sec)</strong></td><td>Switch Remote Desktop Manager back to online mode the set number of seconds after the VPN disconnects, from 0 to 180.</td></tr><tr><td><strong>Use adapter to detect connection</strong></td><td>Use the network adapter to detect whether the VPN is connected.</td></tr><tr><td colspan="2"><strong>After execution, wait</strong></td></tr><tr><td><strong>After execution, wait</strong></td><td><p>What Remote Desktop Manager waits for after starting the VPN:</p><ul><li><strong>Delay</strong> — Waits for the set number of seconds, from -1 to 180.</li><li><strong>For IP on adapter</strong> — Waits for an IP address on the network adapter. Enter the adapter name or device name, or click the browse button to select it. The field can be left blank. <em><strong>Wait a maximum of</strong></em> sets the maximum wait in seconds (-1 to 180), and <em><strong>Then delay</strong></em> adds a delay in milliseconds (-1 to 180000).</li></ul></td></tr><tr><td colspan="2"><strong>Commands</strong></td></tr><tr><td><strong>Commands</strong></td><td>The list of VPN commands, with their <em><strong>Name</strong></em>, <em><strong>After connection command</strong></em>, and <em><strong>Before disconnecting command</strong></em>. Use the toolbar to <em><strong>Add</strong></em>, <em><strong>Edit</strong></em>, <em><strong>Delete</strong></em>, <em><strong>Move up</strong></em>, or <em><strong>Move down</strong></em> a command.<br><br>The settings of the <em><strong>Commands</strong></em> section are available when <em><strong>After execution, wait</strong></em> is set to <em><strong>For IP on adapter</strong></em>. They are not supported on macOS.</td></tr><tr><td><strong>After connecting, VPN command enabled</strong></td><td>Run the after connection commands once the VPN is connected.</td></tr><tr><td><strong>Before disconnecting, VPN command enabled</strong></td><td>Run the before disconnecting commands before the VPN disconnects.</td></tr><tr><td><strong>Run routes in batch (forces elevated privileges)</strong></td><td>Run the routes in a batch. This option requires elevated privileges.</td></tr></tbody></table>

### See also

* [VPN/tunnel/gateway](https://docs.devolutions.net/rdm/knowledge-base/knowledge-base-articles/entry-settings/network-access.md)
* [OpenVPN enters wrong credentials](https://docs.devolutions.net/rdm/knowledge-base/troubleshooting-articles/openvpn-enters-wrong-credentials.md)
* [OpenVPN loses connection at launch](https://docs.devolutions.net/rdm/knowledge-base/troubleshooting-articles/openvpn-loses-connection-at-launch.md)


---

# 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/rdm/knowledge-base/knowledge-base-articles/entry-settings/openvpn.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.
