Skip to content

nexoslabs/vpn-toolkit

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

3 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Bash GitHub code GitHub stars License: MIT

VPN Toolkit πŸ›‘οΈ

A simple, lightweight, zero-dependency VPN management toolkit for Linux (Fedora, Ubuntu, Arch), supporting OpenVPN and WireGuard.
Easily manage VPN profiles, connect/disconnect, and add/remove configs β€” all from the command line.


🌟 Features

  • πŸ“‹ List available VPN profiles (myvpn list)
  • πŸ“‘ Show active VPN connections (myvpn status)
  • πŸ”‘ Connect to OpenVPN or WireGuard (myvpn connect <name>)
  • πŸ”’ Disconnect VPN (myvpn disconnect <name>)
  • βž• Add new VPN configurations (myvpn add openvpn <file.ovpn> / myvpn add wireguard <file.conf>)
  • πŸ—‘ Remove VPN configurations safely (myvpn remove <name>)
  • ❓ Zero extra dependencies (uses only Bash, OpenVPN, WireGuard, systemctl)

πŸš€ Installation

Run a single command to install the toolkit:

curl -s https://raw.githubusercontent.com/nexoslabs/vpn-toolkit/main/install.sh | sudo bash

This will:

  1. Install OpenVPN and WireGuard if missing.
  2. Download myvpn.sh into /usr/local/bin/myvpn.
  3. Make it executable.

No other dependencies are required.


πŸ›  Usage

# List available VPN profiles
myvpn list

# Show active VPN connections
myvpn status

# Connect to a VPN
myvpn connect <name>

# Disconnect a VPN
myvpn disconnect <name>

# Add a new OpenVPN configuration
myvpn add openvpn ~/Downloads/myvpn.ovpn

# Add a new WireGuard configuration
myvpn add wireguard ~/Downloads/home.conf

# Remove a VPN configuration
myvpn remove <name>

Example:

myvpn add openvpn ~/Downloads/work.ovpn
myvpn connect work
myvpn status
myvpn disconnect work
myvpn remove work

🀝 Contributing

We ❀️ contributions! Follow these steps to contribute:

  1. 🍴 Fork the repository
  2. 🌿 Create a new 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

πŸ“– See our Contribution Guidelines for more details.


πŸ“„ License

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


πŸ“¬ Contact & Community

πŸ’¬ Join us on Discord: Click Here
🐦 Follow on Twitter: @nexoslabs
πŸ“§ Email: contact@nexoscreation.tech

Made with ❀️ by the @nexoslabs Team

⭐ Star us on GitHub!

Notes

  • OpenVPN configs should be placed in /etc/openvpn/client/ and WireGuard configs in /etc/wireguard/.
  • The toolkit relies on system-provided wg-quick and openvpn-client@.service for starting/stopping connections.
  • Always run myvpn connect <name> with sudo if required by system services.

Built with ❀️ for Linux users who want a simple, fast VPN CLI manager.

About

A simple, lightweight, zero-dependency VPN management toolkit for Linux (Fedora, Ubuntu, Arch), supporting OpenVPN and WireGuard.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

3 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors

Languages