Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/wooyek/ovpn3
OpenVPN 3 CLI for automatic session start with credentials read from os keyring
https://github.com/wooyek/ovpn3
Last synced: 4 days ago
JSON representation
OpenVPN 3 CLI for automatic session start with credentials read from os keyring
- Host: GitHub
- URL: https://github.com/wooyek/ovpn3
- Owner: wooyek
- License: agpl-3.0
- Created: 2021-12-23T14:26:09.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2022-02-07T17:11:33.000Z (almost 3 years ago)
- Last Synced: 2024-11-10T09:43:27.259Z (2 months ago)
- Language: Python
- Size: 39.1 KB
- Stars: 0
- Watchers: 2
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ovpn3
OpenVPN 3 CLI for automatic session start with credentials read from os keyring
# Setup
1. First setup `openvpn3` configuration profile:
```bash
openvpn3 config-import --persistent --name --config
```
2. Back `resolv.conf` openvpn3 is known leave the changed version on system restart.
```bash
sudo cp /etc/resolv.conf /etc/resolv.conf.ovpn3bak
```
3. Install `ovpn3` you os py3, so `openvpn3` will be available:
```bash
pip3 install --user ovpn3
```
4. Then setup `ovpn3` and store your password and optionally TOTP key in your keyring:
```bash
ovpn3 setup
```
5. Connect with `ovpn3` credentials will be provided based on data stored in the keyring:
```bash
ovpn3 connect
```
# Warning
This is still an alpha version with no support.
## Troubleshooting
Run your commands with DEBUG verbosity:
```bash
ovpn3 -v DEVBUG
```
## Known issues
### Resolv conf is not being restored after disconnection
This may not be related to this tool but OpenVPN in general. In some cases
changes done to `/etc/resolv.conf` are not rolled back. OpenVPN does create
a backup `/etc/resolv.conf.ovpn3bak` but it is sometimes overwritten on
reconnection.