Sign inSign up

boingbasti/nordvpn-gateway-configurator

By boingbasti

ā€¢Updated about 1 month ago

Image
0

5.4K

boingbasti/nordvpn-gateway-configurator repository overview

ā šŸŽ›ļø NordVPN Gateway Config Generator

A lightweight, web-based tool that interactively creates valid and production-ready docker-compose.yml configurations for the NordVPN Gatewayā .

Why this tool exists? Creating networking-correct, typo-proof, and logically consistent gateway configs can be tedious ā€” especially when dealing with macvlan, WireGuard integration, capabilities, sysctls, and multi-container dependencies.

This generator handles all dependencies for you and produces a clean, turnkey YAML.

ā āœØ Key Features

  • āš” Instant Configuration ā€” Build your YAML visually. No manual editing required.
  • šŸ›”ļø Error-Safe ā€” Prevents incompatible settings and impossible combinations (e.g., hides WireGuard fields when macvlan is not selected).
  • šŸ§© Stack Builder ā€” Easily add optional services that work out-of-the-box:
    • SOCKS5 Proxy
    • HTTP Proxy (Privoxy)
    • AdGuard Home (DNS over VPN)
    • wg-easy (WireGuard Server UI)
  • šŸ”§ Expert Mode ā€” Fine-tune advanced settings:
    • VPN MTU & Killswitch
    • LAN Discovery
    • Smart Server Selection
    • Threat Protection Lite
    • Speed-Monitoring & Self-Healing
  • šŸ”— WireGuard Helper ā€” Automatically calculates the correct PostUp / PostDown commands based on your selected IP and subnet values.
  • šŸŒ Multi-Architecture ā€” Fully compatible with AMD64, ARM64, and ARMv7 (Raspberry Pi).

ā šŸš€ Usage

ā 1. Run via Docker CLI (Recommended)

This starts a tiny web server (~15MB).

docker run -d \
  --name nordvpn-config-gen \
  -p 8080:80 \
  boingbasti/nordvpn-gateway-configurator:latest

šŸ‘‰ Open in Browser: http://localhost:8080ā 

ā 2. Run via Docker Compose
services:
  configurator:
    image: boingbasti/nordvpn-gateway-configurator:latest
    container_name: nordvpn-config-gen
    ports:
      - "8080:80"
    restart: unless-stopped

ā šŸ›  How it works

The generator is more than just a YAML printer. It contains logic to ensure your configuration is valid.

ā 1. Network Architecture
  • Simple Proxy: Uses standard bridge network. Good for simple SOCKS5 usage.
  • Advanced Gateway: Uses macvlan. Assigns a static IP to the container so it can act as a router for your LAN.
ā 2. Intelligent Logic & Validation

The tool actively prevents configuration errors:

Logic RuleBehavior
WireGuard BypassIf enabled, the generator forces 'Advanced Gateway' mode (macvlan) because bypass routing is impossible in bridge mode.
OpenVPNIf 'OpenVPN' is selected as technology, the Protocol (UDP/TCP) dropdown automatically appears.
Smart SelectionIf 'Smart Server Selection' is disabled, related fields (Check Interval) are hidden to keep the UI clean.
Token SafetyThe token input field is locked until 'Embed Token' is checked. Unchecking clears the field automatically.
AdGuardIf AdGuard is enabled, the generator ensures it is attached via network_mode: service:vpn to prevent DNS leaks.
ā 3. Final Output
  • Indentation-correct
  • Valid YAML syntax
  • Guaranteed working configuration
  • No guessing ā€” just copy & paste.

ā šŸ“Ž Links

ā Configurator (This Tool)
ā Main Gateway Project

ā šŸŖŖ License

MIT

Tag summary

Content type

Image

Digest

sha256:dd5634bdaā€¦

Size

24.8 MB

Last updated

about 1 month ago

docker pull boingbasti/nordvpn-gateway-configurator