2025-02-12 14:30:34Samuli Seppänen:
Add non-AI version of OpenVPN-GUI-New
Pages/OpenVPN-GUI-New.md ..
@@ 1,82 1,106 @@
-
# Using the 'OpenVPN-GUI for Windows'
+
# Using the OpenVPN-GUI for Windows
+
+
+
----
+
+
+
**Important Note**: Please see the Official Readme here: https://github.com/OpenVPN/openvpn-gui#readme
+
+
+
----
-
---
-
**Important Note**: Please see the Official Readme here: [https://github.com/OpenVPN/openvpn-gui#readme](https://github.com/OpenVPN/openvpn-gui#readme)
-
---
**Notes:**
-
- This page **requires** that you have already installed [OpenVPN on a Windows OS Computer](https://openvpn.net/community-downloads/)
-
- Some of the screenshots here may not accurately match the current OpenVPN-GUI.
+
- This page **requires** that you have already installed [OpenVPN on a Windows OS Computer](https://openvpn.net/community-downloads/)
+
+
- For Windows XP/Vista see the old [wiki:OpenVPN-GUI]
+
+
- Some of the screenshots here may not accurately match the current OpenVPN-GUI.
+
+
+
+
----
+
## Locating the OpenVPN-GUI
The OpenVPN-GUI Tray Icon:
-
+
-
If you cannot find the OpenVPN-GUI icon then check that Windows has not hidden it from you. (Because Windows likes to hide things from you ..)
+
If you cannot find the OpenVPN-GUI icon then check that Windows has not hidden it from you.
+
(Because Windows likes to hide things from you ..)
Windows hidden icons:
-
+
-
If you still cannot find the OpenVPN-GUI then make sure you opened it in the first place.
+
If you still cannot find the OpenVPN-GUI then make sure you opened it in the first place.
-
You may use a desktop icon or the Windows menu to locate the OpenVPN-GUI.
+
You may use a desktop icon or the Windows menu to locate the OpenVPN-GUI.
This is the OpenVPN-GUI desktop icon:
-
+
+
Additional notes:
+
* You should now have access to the OpenVPN-GUI.
-
---
+
+
----
+
## Preparing your installation to use the OpenVPN-GUI successfully
Press OK -- All config files **must** have unique names.
+
Press OK -- All config files **must** have unique names.
Additional notes:
+
* OpenVPN-GUI searches the entire directory tree (including sub-directories) of the following locations:
-
* `\Program Files\OpenVPN\config` (`\Program Files` is the default installation directory)
-
* `\Users\$USERNAME\OpenVPN\config`
+
* `\Program Files\OpenVPN\config` (`\Program Files` is the default installation directory)
+
* `\Users\$USERNAME\OpenVPN\config`
+
+
All `*.ovpn` files in these locations, including sub-directories, **must** have unique names.
-
All `*.ovpn` files in these locations, including sub-directories, **must** have unique names.
+
----
-
---
## Importing your first connection profile (config file) into the OpenVPN-GUI
Select "Import->Import file ..." from the menu, then select the `config.ovpn` file you wish to import:
-
+
If the import is successful you will see:
-
+
If your server administrator has provided a URL, username and password for importing from the server, use "Import->Import from URL..." or "Import->Import from Access Server..." and complete the dialog that opens up.
@@ 85,86 109,104 @@
If you do not know what to do then please contact your server's administrator for help.
Additional notes:
+
* You should now have a successfully imported configuration file.
-
---
-
## Setting up membership of the OpenVPN Administrators local group
+
----
+
-
In order for your `limited user` account without administrator privileges to be able to use openvpn, your user account must be added to the `OpenVPN Administrators` group on your computer. This is normally done during the install phase but it may not have been done. If you see the message below you can select `Yes` but you will need the Local Administrator password to continue. If you do not have this password then please contact your network administrator for help.
+
## Setting up membership of the OpenVPN Administrators local group
+
+
In order for your `limited user` account without administrator privileges to be able to use openvpn, your user account must be added to the `OpenVPN Administrators` group on your computer. This is normally done during the install phase but it may not have been done. If you see the message below you can select `Yes` but you will need the Local Administrator password to continue. If you do not have this password then please contact your network administrator for help.
Message dialogue `Require membership in OpenVPN Administrators group`
If your server requires a username and password you will see this dialogue box.
Additional notes:
+
* Your client.ovpn file **must** contain the `--auth-user-pass` directive.
* You can choose to save the password but the username is always saved.
@@ 173,61 215,71 @@
* The "enter user/pass timeout" can not be configured
-
The way it works is like this: if username/password is available, the dialog window is prefilled and displayed for 6 seconds. If during that time the user clicks on the window, the timeout is cancelled and the dialog stays on the screen until manually submitted. Otherwise it's auto-submitted after the 6 seconds timeout.
+
The way it works is like this: if username/password is available, the dialog window is prefilled and displayed for 6 seconds. If during that time the user clicks on the window, the timeout is cancelled and the dialog stays on the screen until manually submitted. Otherwise it's auto-submitted after the 6 seconds timeout.
-
The 6 seconds value is not configurable.
+
The 6 seconds value is not configurable.
-
If silent-connection is enabled and the username/password are saved then the dialog is not shown.
+
If silent-connection is enabled and the username/password are saved then the dialog is not shown.
**WARNING**
-
Editing the Windows Registry is **strongly discouraged** .. Do so ONLY AT YOUR OWN RISK!
+
Editing the Windows Registry is **strongly discouraged** .. Do so ONLY AT YOUR OWN RISK!
+
+
+
----
-
---
## Trouble shooting
Error connecting:
-
+
-
The first thing to do is examine your log file for details of the errors encountered.
+
The first thing to do is [#gui-logfile examine your log file] for details of the errors encountered.
Additional notes:
+
* For help with trouble shooting connection problems please see [HOWTO: Request Help ! {2}](https://forums.openvpn.net/viewtopic.php?f=30&t=22603#p68963)
Common connection problems:
+
* `TLS Error: TLS key negotiation failed to occur within 60 seconds`
This means that you cannot reach the server -- Please contact your server administrator for help.
-
Please help improve this section, you can submit here
+
Please help improve this section.
+
+
+
----
-
---
## OpenVPN-GUI Settings
Most of the OpenVPN-GUI settings can be left as default but you should examine them to make sure this suites your requirements.
-
### The Settings menu, **General** tab:
+
### The Settings menu, General tab
-
+
-
### The Settings menu, **Proxy** tab:
+
### The Settings menu, Proxy tab
-
+
-
### The Settings menu, **Advanced** tab:
+
### The Settings menu, Advanced tab
-
+
-
### The Settings menu, **About** tab:
+
### The Settings menu, About tab
-
+
+
+
+
----
-
---
You are now ready to use OpenVPN-GUI for Windows.
-
---
+
+
----
+
## Built-in help
@@ 237,62 289,66 @@
`--connect`
-
`--connect cnn` : Connect to `cnn` **at startup**.
-
(File extension is optional, default is .ovpn)
+
`--connect cnn` : Connect to `cnn` **at startup**. [[br]]
+
(File extension is optional, default is .ovpn)
-
Example: `openvpn-gui --connect office.ovpn`
+
Example: `openvpn-gui --connect office.ovpn`
-
Example: `openvpn-gui --command connect office` (See `--command` below)
+
Example: `openvpn-gui --command connect office` (See `--command` below)
`--command`
-
`--command cmd [args]` : Send a command `cmd` to **a running instance** of the GUI.
-
(File extension is optional, default is .ovpn)
+
`--command cmd [args]` : Send a command `cmd` to **a running instance** of the GUI. [[br]]
+
(File extension is optional, default is .ovpn)
-
Supported commands:
+
Supported commands:
-
| **Command** | **Description** | **Status** |
-
|-------------|-----------------|--------------|
-
| `connect cnn` | connect the config named `cnn` | Supported |
-
| `disconnect cnn` | disconnect the config named `cnn` | Supported |
-
| `reconnect cnn` | reconnect the config named `cnn` | Supported |
-
| `disconnect_all` | disconnect all connected configs | Supported |
-
| `exit` | terminate the running GUI instance (may ask for confirmation) | Supported |
-
| `status cnn` | show the status window of config `cnn` if connected | Supported |
-
| `silent_connection [0|1]` | set the silent_connection flag on (1) or off (0) | Supported |
+
| **Command** | **Description** | **Status** |
+
|-|-|-|
+
| `connect cnn` | connect the config named `cnn` | Supported |
+
| `disconnect cnn` | disconnect the config named `cnn` | Supported |
+
| `reconnect cnn` | reconnect the config named `cnn` | Supported |
+
| `disconnect_all` | disconnect all connected configs | Supported |
+
| `exit` | terminate the running GUI instance (may ask for confirmation) | Supported |
+
| `status cnn` | show the status window of config `cnn` if connected | Supported |
+
| `silent_connection [0|1]` | set the silent_connection flag on (1) or off (0) | Supported |
Then the most likely cause is that OpenVPN has already started the connection profile.
-
You must ensure that all `openvpn.exe` processes are terminated and then try again.
+
Then the most likely cause is that OpenVPN has already started the connection profile. [[br]]
+
You must ensure that all `openvpn.exe` processes are terminated and then try again.[[br]]
The most common cause of this problem is when you use the incorrect OpenVPN Windows services:
-
* **Stop** and **do not use** both the `OpenVPNService` and the `OpenVPN Legacy Service` Windows services.
-
* **Start** and **do use** the `OpenVPN Interactive Service` Windows service.
+
* **Stop** and **do not use** both the `OpenVPNService` and the `OpenVPN Legacy Service` Windows services. [[br]]
+
* **Start** and **do use** the `OpenVPN Interactive Service` Windows service.
+
+
+
----
-
---
## Known issues
-
* Windows 10: If your TAP adapter fails to start but you are using a known good config that used to work with Windows 7:
+
* Windows 10: If your TAP adapter fails to start but you are using a known good config that used to work with Windows 7:
+
+
Try unplugging the ethernet cable and disabling wifi after you install Openvpn then reconnect the cable or reconnect to your wifi and try Openvpn again.
-
Try unplugging the ethernet cable and disabling wifi after you install Openvpn then reconnect the cable or reconnect to your wifi and try Openvpn again.
