# GlobalProtect-openconnect Docker image This image provides the GlobalProtect-openconnect command-line tools on Alpine Linux. It includes: - `gpclient` - connect to and disconnect from GlobalProtect VPN portals and gateways - `gpauth` - authentication helper used by `gpclient` The image does not include embedded webview authentication, `gpgui-helper`, or the graphical `gpgui` application. ## Pull ```bash docker pull yuezk/globalprotect-openconnect: ``` Release images are tagged as `vX.Y.Z`, `X.Y.Z`, and `latest`. ## Usage VPN tunnel creation requires access to `/dev/net/tun` and the `NET_ADMIN` capability: ```bash docker run --rm -it --cap-add=NET_ADMIN --device=/dev/net/tun \ yuezk/globalprotect-openconnect: \ connect ``` For browser authentication in a headless environment, use manual browser authentication: ```bash docker run --rm -it --cap-add=NET_ADMIN --device=/dev/net/tun \ yuezk/globalprotect-openconnect: \ connect --browser manual ``` On a Linux host, add host networking if the VPN routes should affect the host network namespace: ```bash docker run --rm -it --network host --cap-add=NET_ADMIN --device=/dev/net/tun \ yuezk/globalprotect-openconnect: \ connect --browser manual ``` Without `--network host`, the VPN connection stays inside the container network namespace. Docker Desktop on macOS and Windows does not make the host use the VPN through `--network host`; run `gpclient` on the host or use a container gateway setup for host traffic. ## Common commands Show top-level help: ```bash docker run --rm yuezk/globalprotect-openconnect: --help ``` Show help for a command: ```bash docker run --rm yuezk/globalprotect-openconnect: help connect ``` ## Project GlobalProtect-openconnect is a modern GlobalProtect VPN client for Linux, built on OpenConnect with support for SSO, non-SSO, FIDO2, client certificate authentication, multiple portals and gateways, and direct gateway connections. Source: https://github.com/yuezk/GlobalProtect-openconnect