wireguard_webadmin is an intuitive web interface for WireGuard VPN management, designed to simplify the configuration and oversight of VPNs. It supports multi-user access and multiple WireGuard instances. Built on open-source principles and Ideal for administrators seeking an efficient and user-friendly VPN management solution.
Find a file
2024-02-23 14:23:22 -03:00
accounts User and permission management 2024-02-15 11:02:22 -03:00
api Update check 2024-02-23 14:23:22 -03:00
console Pending configuration warning and reload 2024-02-16 17:14:35 -03:00
cron Update check 2024-02-23 14:23:22 -03:00
screenshots readme screenshots 2024-02-17 17:29:57 -03:00
static_files User and permission management 2024-02-15 10:57:59 -03:00
templates Update check 2024-02-23 14:23:22 -03:00
user_manager User level check implementation 2024-02-15 12:34:51 -03:00
wgwadmlibrary Initial commit 2024-02-14 16:36:01 -03:00
wireguard Update check 2024-02-23 14:23:22 -03:00
wireguard_peer Peer list with details 2024-02-17 11:53:51 -03:00
wireguard_tools Update check 2024-02-23 14:23:22 -03:00
wireguard_webadmin Update check 2024-02-23 14:23:22 -03:00
.gitignore Small deployment fixes 2024-02-15 22:20:44 -03:00
docker-compose-no-nginx-dev.yml Update check 2024-02-23 14:23:22 -03:00
docker-compose-no-nginx.yml Update check 2024-02-23 14:23:22 -03:00
docker-compose.yml Update check 2024-02-23 14:23:22 -03:00
Dockerfile Improved docker-compose to handle server_address. Also added an option to run without nginx. 2024-02-16 11:59:03 -03:00
entrypoint.sh Update check 2024-02-23 14:23:22 -03:00
init.sh Initial commit 2024-02-14 16:36:01 -03:00
LICENSE Create LICENSE 2024-02-14 17:28:37 -03:00
manage.py Initial commit 2024-02-14 16:36:01 -03:00
README.md readme screenshots 2024-02-17 17:29:57 -03:00
requirements.txt Update check 2024-02-23 14:23:22 -03:00
virtualhost.conf Small deployment fixes 2024-02-15 22:20:44 -03:00

wireguard_webadmin

wireguard_webadmin is a full-featured yet easy-to-configure web interface for managing WireGuard VPN instances. Designed to simplify the administration of WireGuard networks, it provides a user-friendly interface that supports multiple users with varying access levels, multiple WireGuard instances with individual peer management, and support for crypto key routing for site-to-site interconnections.

Features

  • Multi-User Support: Manage access with different permission levels for each user.
  • Multiple WireGuard Instances: Enables separate management for peers across multiple instances.
  • Crypto Key Routing: Simplifies the configuration for site-to-site interconnections.

This project aims to offer an intuitive and user-friendly solution for WireGuard VPN management without compromising the power and flexibility WireGuard provides.

License

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

Screenshots

Wireguard Peer List Wireguard Server Configuration Console User Manager

Deployment

Follow these steps to deploy wireguard_webadmin:

  1. Clone the repository:

    git clone https://github.com/eduardogsilva/wireguard_webadmin
    
  2. Place your SSL certificates for nginx in the certificates volume. The files should be named nginx.pem and nginx.key. You can use self-signed certificates and accept the certificate exception in your browser.

  3. Run Docker Compose (choose one):

    This mode is recommended for running the webadmin. Set up your certificates for nginx; you can use a self-signed certificate. If you don't have a DNS name pointing to your server, use SERVER_ADDRESS=ip_address.

    SERVER_ADDRESS=yourserver.example.com docker-compose up --build -d
    

    Access the web interface using https://yourserver.example.com.

    Without NGINX (Debug mode and testing only)

    This mode does not require SSL certificates and runs Django with DEBUG=True. Not recommended for production use without HTTPS.

    docker-compose -f docker-compose-no-nginx.yml up --build -d
    

    Access the web interface using http://127.0.0.1:8000.

After completing these steps, your wireguard_webadmin should be up and running. Begin configuration by accessing your server.

Contributing

Contributions make the open-source community an amazing place to learn, inspire, and create. Your contributions are greatly appreciated.

Support

If you encounter any issues or require assistance, please open an issue on the project's GitHub page.