GNOME Shell extension for GlobalProtect VPN CLI integration. Native system tray indicator with full VPN management.
Note: Designed for GlobalProtect CLI (PanGPLinux) - the official Palo Alto Networks VPN client for Linux.
| Category | Features |
|---|---|
| Connection | Connect/Disconnect with MFA support, Gateway selection, Stays connected on screen lock, Configurable auto-disconnect on lock/logout |
| Monitoring | Real-time status, Configurable polling (3-60s), Custom status icons |
| Settings | Portal address, Username, SSL-only mode, Log level, Certificate import |
| Advanced | Network rediscovery, HIP resubmission, Log collection, Diagnostics |
| Info | Host state (HIP), Errors, Notifications, Help, Version |
- GNOME Shell 45, 46, 47, 48, 49, 50, or 51
- GlobalProtect CLI installed (
globalprotectcommand available)
→ Install from extensions.gnome.org
# Download and install
wget https://github.com/totoshko88/gp-gnome/releases/latest/download/gp-gnome@totoshko88.github.io.zip
gnome-extensions install gp-gnome@totoshko88.github.io.zip --force
gnome-extensions enable gp-gnome@totoshko88.github.io
# Restart GNOME Shell
# Wayland: Log out and back in
# X11: Alt+F2 → r → Entergit clone https://github.com/totoshko88/gp-gnome.git
cd gp-gnome
make install
gnome-extensions enable gp-gnome@totoshko88.github.io- Click the extension icon in system tray
- Open Settings → Set your portal address
- Click Connect
- Complete MFA in browser if prompted
| Icon | State |
|---|---|
| 🟢 Green | Connected |
| 🔴 Red | Disconnected |
| 🟡 Yellow | Connecting/Disconnecting |
| 🟠 Orange | Error |
Click extension icon → Settings
gsettings set org.gnome.shell.extensions.gp-gnome portal-address "vpn.example.com"
gsettings set org.gnome.shell.extensions.gp-gnome poll-interval 10
gsettings set org.gnome.shell.extensions.gp-gnome username "your-username"
gsettings set org.gnome.shell.extensions.gp-gnome ssl-only trueThe extension does not manage the VPN across screen lock or logout. The GlobalProtect daemon owns the tunnel, so the connection stays up while the screen is locked regardless of the extension's state. To disconnect, use the extension's Connect/Disconnect toggle or the globalprotect disconnect command.
# Check if enabled
gnome-extensions list --enabled | grep gp-gnome
# Check logs
journalctl -f -o cat /usr/bin/gnome-shell | grep -i gp-gnome
# Restart GNOME Shell (Wayland: log out/in, X11: Alt+F2 → r)# Verify CLI works
globalprotect show --status
# Check CLI version
globalprotect --version# Recompile schema
cd ~/.local/share/gnome-shell/extensions/gp-gnome@totoshko88.github.io/
glib-compile-schemas schemas/# Run tests
make test
# Create distribution package
make dist
# Validate against EGO guidelines
bash tests/validate-review-guidelines.sh- CHANGELOG.md - Version history
- CONTRIBUTING.md - How to contribute
- DISTRIBUTION.md - Release process
- SECURITY.md - Security policy and supported versions
GPL-3.0 — Made with ❤️ in Ukraine 🇺🇦
