OVBox - Modern OpenVPN 3 GUI Manager

A beautiful, modern GUI manager for OpenVPN 3 on Linux

English • Tiếng Việt • Bahasa Indonesia • 中文 • 한국어 • 日本語 • Français • Deutsch • Español • ภาษาไทย • Bahasa Melayu • Русский • Filipino • Português

---

📋 Overview

OVBox is a modern, user-friendly graphical interface for managing OpenVPN 3 connections on Linux. Built with Electron.js, it provides an intuitive way to import, manage, and connect to VPN profiles with support for authentication, real-time monitoring, and multi-language support.

✨ Features

🔐 Profile Management

• Import OpenVPN profiles (.ovpn files)
• Auto-detection of authentication requirements
• Credential storage - Enter username/password once during import
• Automatic cleanup - Removes unsupported directives (compress, comp-lzo)
• Grid layout - Beautiful, compact profile display
• Easy deletion - Remove profiles with one click

🌐 Connection Management

• One-click connect/disconnect
• Multiple connection modes:
  • Standard Mode
  • Stable Mode (Persistent TUN)
  • Auto-Reconnect Mode
• Real-time status monitoring
• Automatic reconnection on network issues
• System tray integration - Control VPN from tray icon

📊 Monitoring & Information

• Public IP address display (before and after VPN connection)
• ISP information with location details
• Real-time bandwidth monitoring (Download/Upload speeds)
• Connection statistics
• Activity logs with detailed events
• Session management

🌍 Multi-Language Support

OVBox supports 14 languages:

• 🇺🇸 English
• 🇻🇳 Tiếng Việt (Vietnamese)
• 🇮🇩 Bahasa Indonesia (Indonesian)
• 🇨🇳 中文 (Chinese Simplified)
• 🇰🇷 한국어 (Korean)
• 🇯🇵 日本語 (Japanese)
• 🇫🇷 Français (French)
• 🇩🇪 Deutsch (German)
• 🇪🇸 Español (Spanish)
• 🇹🇭 ภาษาไทย (Thai)
• 🇲🇾 Bahasa Melayu (Malay)
• 🇷🇺 Русский (Russian)
• 🇵🇭 Filipino (Tagalog)
• 🇵🇹 Português (Portuguese)

🎨 User Interface

• Modern dark theme - Easy on the eyes
• Responsive design - Adapts to different window sizes
• Smooth animations - Polished user experience
• System tray support - Minimize to tray
• Native notifications

📦 Requirements

System Requirements

• Operating System: Linux (Ubuntu, Debian, Fedora, Arch, etc.)
• OpenVPN 3: Must be installed on your system
• Node.js: 14.x or higher (for development)

Installing OpenVPN 3

Ubuntu/Debian

sudo apt install apt-transport-https
sudo wget https://swupdate.openvpn.net/repos/openvpn-repo-pkg-key.pub
sudo apt-key add openvpn-repo-pkg-key.pub
sudo wget -O /etc/apt/sources.list.d/openvpn3.list https://swupdate.openvpn.net/community/openvpn3/repos/openvpn3-$(lsb_release -cs).list
sudo apt update
sudo apt install openvpn3

Fedora

sudo dnf install openvpn3-client

Arch Linux

yay -S openvpn3

🚀 Installation

Option 1: Download Pre-built Binary (Recommended)

1. Go to the Releases page
2. Download the latest .AppImage or .deb file
3. Make it executable and run:

chmod +x OVBox-*.AppImage
./OVBox-*.AppImage

Option 2: Build from Source

# Clone the repository
git clone https://github.com/yourusername/ovbox.git
cd ovbox

# Install dependencies
npm install

# Run the application
npm start

# Build for distribution
npm run build

📖 Usage

Importing a VPN Profile

1. Click "Import Profile" button or use File → Import Profile menu
2. Select your .ovpn configuration file
3. If authentication is required, enter username and password
4. Profile will be imported and ready to use

Connecting to VPN

1. Select a profile from the grid
2. Choose connection mode (Stable Mode recommended)
3. Click "Connect"
4. Wait for connection to establish
5. Monitor your new IP address and bandwidth

Managing Profiles

• Delete: Click the trash icon on any profile card
• Refresh: Click refresh button to reload profiles
• View Details: Select a profile to see connection info

System Tray

• Double-click: Show/Hide main window
• Right-click: Access quick actions menu
• Tooltip: View connection status and statistics

🔧 Configuration

Profile Files Location

Imported profiles are stored in:

~/.config/openvpn3/

Credentials Storage

Authentication credentials are stored securely in:

<profile-directory>/<profile-name>-pass.txt

Modified Profiles

OVBox creates modified versions of profiles to ensure compatibility:

<profile-directory>/<profile-name>-modified.ovpn

🛠️ Troubleshooting

Connection Issues

• Authentication failed: Re-import the profile and check credentials
• Cannot connect: Ensure OpenVPN 3 is installed and running
• Disconnects immediately: Check if profile has unsupported directives

Profile Issues

• Profile not showing: Click refresh button
• Import failed: Check if .ovpn file is valid
• Compress errors: OVBox automatically removes unsupported compress directives

Common Errors

# Check OpenVPN 3 status
openvpn3 sessions-list

# View logs
openvpn3 log --session-path <path>

# Restart OpenVPN 3 service
sudo systemctl restart openvpn3

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Built with Electron.js
• Uses OpenVPN 3 Linux
• Icon design inspired by modern VPN aesthetics

📞 Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Email: support@ovbox.tech

---

Made with ❤️ by the OVBox Team