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-16 11:59:03 -03:00
accounts User and permission management 2024-02-15 11:02:22 -03:00
console Initial commit 2024-02-14 16:36:01 -03:00
static_files User and permission management 2024-02-15 10:57:59 -03:00
templates Improved docker-compose to handle server_address. Also added an option to run without nginx. 2024-02-16 11:59:03 -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 better placeholder for status page 2024-02-15 12:48:40 -03:00
wireguard_peer User level check implementation 2024-02-15 12:34:51 -03:00
wireguard_tools Small deployment fixes 2024-02-15 22:20:44 -03:00
wireguard_webadmin Small deployment fixes 2024-02-15 22:20:44 -03:00
.gitignore Small deployment fixes 2024-02-15 22:20:44 -03:00
docker-compose-no-nginx-dev.yml Improved docker-compose to handle server_address. Also added an option to run without nginx. 2024-02-16 11:59:03 -03:00
docker-compose-no-nginx.yml Improved docker-compose to handle server_address. Also added an option to run without nginx. 2024-02-16 11:59:03 -03:00
docker-compose.yml Improved docker-compose to handle server_address. Also added an option to run without nginx. 2024-02-16 11:59:03 -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 Improved docker-compose to handle server_address. Also added an option to run without nginx. 2024-02-16 11:59:03 -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 Improved docker-compose to handle server_address. Also added an option to run without nginx. 2024-02-16 11:59:03 -03:00
requirements.txt Small deployment fixes 2024-02-15 22:20:44 -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.

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.