Skip to content
OpenVPN 3 Linux Client OpenVPN 3 Linux Client

CLI Reference

The companion CLI (ovpn-gui) shares the same service layer as the GUI. All commands support --json for machine-readable output.

Profile Management

Section titled “Profile Management”
Terminal window
ovpn-gui profiles list
ovpn-gui profiles import-file /path/to/profile.ovpn
ovpn-gui profiles import-url https://vpn.example.com/profile.ovpn
ovpn-gui profiles rename PROFILE_ID "My VPN"
ovpn-gui profiles remove PROFILE_ID

Sessions

Section titled “Sessions”
Terminal window
ovpn-gui sessions connect PROFILE_ID
ovpn-gui sessions status SESSION_ID
ovpn-gui sessions pause SESSION_ID
ovpn-gui sessions resume SESSION_ID
ovpn-gui sessions disconnect SESSION_ID

Settings

Section titled “Settings”
Terminal window
ovpn-gui settings list
ovpn-gui settings set protocol tcp
ovpn-gui settings set launch_behavior restore-connection

Proxy Management

Section titled “Proxy Management”
Terminal window
ovpn-gui proxies list
ovpn-gui proxies add --name "Corp Proxy" --type http --host proxy.corp.com --port 8080
ovpn-gui profiles assign-proxy PROFILE_ID PROXY_ID

Diagnostics

Section titled “Diagnostics”
Terminal window
ovpn-gui doctor
ovpn-gui doctor logs
ovpn-gui doctor export
ovpn-gui doctor dbus-surface