Skip to content

henri26mobu/wiregui

 
 

Repository files navigation

WireGUI

A graphical user interface for WireGuard — Linux & macOS

Latest Release License Platform Electron

🇫🇷 Version française


Actively maintained fork by @henri26mobu
Based on the original project by Devsfy/wiregui, unmaintained since 2021.


Features

  • 🔌 Connect / disconnect WireGuard tunnels
  • 📋 List all saved tunnels
  • 📊 Live stats of the active tunnel (endpoint, handshake, transfer)
  • 📅 Display last connection date
  • 👁 Show / hide private keys
  • 📤 Export tunnel configuration as .conf file
  • 📱 QR code to import config on mobile
  • 🔐 Polkit authentication for VPN toggle (no interactive sudo)

Download

Head to the Releases page to download the latest version.

Platform File
Linux Debian / Ubuntu / Mint wiregui_x.x.x_amd64.deb
Linux Fedora / CentOS / RHEL wiregui-x.x.x-1.x86_64.rpm
Linux universal (Arch, Manjaro, etc.) wiregui-x.x.x-x86_64.AppImage
macOS Intel wiregui-x.x.x-x64.dmg
macOS Apple Silicon (M1/M2/M3) wiregui-x.x.x-arm64.dmg

Linux (Debian/Ubuntu)

sudo dpkg -i wiregui_x.x.x_amd64.deb

Linux (Fedora/CentOS)

sudo rpm -i wiregui-x.x.x-1.x86_64.rpm

Linux (AppImage — Arch, Manjaro, etc.)

chmod +x wiregui-x.x.x-x86_64.AppImage
./wiregui-x.x.x-x86_64.AppImage

⚠️ AppImage known limitation: live tunnel stats require sudo via sudoers.
This works on Arch/Manjaro but not on Fedora due to SELinux restrictions.
Fedora users should use the .rpm package instead.


Requirements

Linux:

  • WireGuard: sudo apt install wireguard
  • Polkit (included by default on most distributions)

macOS:

  • WireGuard via Homebrew: brew install wireguard-tools
  • Sudoers rights are configured automatically on first launch

Known issues & community fixes

DNS not working after tunnel activation (Arch / Manjaro)

Conflict between wg-quick, openresolv and NetworkManager.
Fix — run these commands once after installing WireGuard:

sudo pacman -S wireguard-tools openresolv polkit
sudo tee /etc/NetworkManager/conf.d/rc-manager.conf << 'END'
[main]
rc-manager=resolvconf
END
sudo ln -sf /run/resolvconf/resolv.conf /etc/resolv.conf
sudo resolvconf -u
sudo systemctl restart NetworkManager

Stats unavailable on Fedora with AppImage

Fedora's SELinux blocks sudo calls from Electron processes without a TTY.
Use the .rpm package instead — it automatically configures the correct permissions via setcap.


Build from source

git clone https://github.com/henri26mobu/wiregui.git
cd wiregui
yarn install
yarn start
yarn make

Tech stack

Tool Version
Electron 28
React 18
Chakra UI 2
TypeScript 5
Node 20

Contributing

Contributions are welcome!

  1. Fork the repo
  2. Create a branch: git checkout -b my-feature
  3. Commit: git commit -m 'feat: my feature'
  4. Push: git push origin my-feature
  5. Open a Pull Request

License

MIT

About

A graphical user interface for WireGuard — Linux & macOS

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • TypeScript 95.9%
  • Shell 2.0%
  • JavaScript 1.4%
  • Other 0.7%