October DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsPC HealthRecommendedCrashes, freezes, slowdowns? Check your PC nowSpot repairable issues before they interrupt work.Check PCOctober DealsAmazon USDeal season is back - check today's better picksAmazon US: current deals, useful picks and tech finds.See Picks×
Skip to content
World desk4 min

How to Set Up Gluetun’s VPN Kill Switch in Docker Compose

Gluetun’s firewall is its VPN kill switch. Configure NET_ADMIN, route protected containers through Gluetun, and handle ports and LAN exceptions carefully.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Gluetun’s firewall already acts as its VPN kill switch: when the VPN connection drops, it blocks traffic from Gluetun and containers sharing its network stack. The essential setup is to give Gluetun the NET_ADMIN capability, configure a supported VPN provider and protocol, and route each protected app through network_mode: "service:gluetun". There is no separate kill-switch toggle in the typical Compose configuration.

How Gluetun’s kill switch works

Gluetun calls the feature its firewall. Its official FAQ says the firewall allows only necessary network traffic and blocks traffic if the VPN connection goes down. The firewall’s default outbound policy permits the VPN connection’s interface, server IP, port, and protocol. See the Gluetun firewall FAQ.

As an Amazon Associate I earn from qualifying purchases.

The protection applies to containers that actually share Gluetun’s network stack. A container that uses an independent network path is not protected merely because Gluetun is running alongside it.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Configure the Compose services

Use this as a minimal shape, not a drop-in provider configuration. Replace the provider and protocol values with ones supported by Gluetun, and supply the credentials or keys required by that provider. Gluetun’s Docker Compose guide shows provider-specific examples, including Mullvad with WireGuard.

#1 Best Overall
Sale
TP-Link ER605, Wired Gigabit VPN Router
  • 【Five Gigabit Ports】1 Gigabit WAN Port plus 2 Gigabit WAN/LAN Ports plus 2 Gigabit LAN Port. Up to 3 WAN ports optimize bandwidth usage through one device.
  • 【One USB WAN Port】Mobile broadband via 4G/3G modem is supported for WAN backup by connecting to the USB port. For complete list of compatible 4G/3G modems, please visit TP-Link website.
  • 【Abundant Security Features】Advanced firewall policies, DoS defense, IP/MAC/URL filtering, speed test and more security functions protect your network and data.
  • 【Highly Secure VPN】Supports up to 20× LAN-to-LAN IPsec, 16× OpenVPN, 16× L2TP, and 16× PPTP VPN connections.
  • Security - SPI Firewall, VPN Pass through, FTP/H.323/PPTP/SIP/IPsec ALG, DoS Defence, Ping of Death and Local Management. Standards and Protocols IEEE 802.3, 802.3u, 802.3ab, IEEE 802.3x, IEEE 802.1q
services:
  gluetun:
    image: qmcgaw/gluetun
    cap_add:
      - NET_ADMIN
    ports:
      - "8080:8080" # Example app web UI, if needed
    environment:
      - VPN_SERVICE_PROVIDER=your_provider
      - VPN_TYPE=wireguard
      # Add the provider-specific credentials and server options.

  app:
    image: your-app-image
    network_mode: "service:gluetun"
    depends_on:
      - gluetun

1. Set the provider and protocol

Configure VPN_SERVICE_PROVIDER and VPN_TYPE, then add the provider’s required authentication and server-selection settings. The placeholder values above are illustrative; they are not valid credentials or universal settings.

2. Give Gluetun network administration capability

Keep NET_ADMIN under cap_add on the Gluetun service. Gluetun needs this capability to manage the network and firewall rules.

Rank #2
GL.iNet GL-SFT1200 Opal Travel Router, AC1200 Dual-Band Wi-Fi
  • 【AC1200 Dual-band Wireless Router】Simultaneous dual-band with wireless speed up to 300 Mbps (2.4GHz) + 867 Mbps (5GHz). 2.4GHz band can handles some simple tasks like emails or web browsing while bandwidth intensive tasks such as gaming or 4K video streaming can be handled by the 5GHz band.*Speed tests are conducted on a local network. Real-world speeds may differ depending on your network configuration.*
  • 【Easy Setup】Please refer to the User Manual and the Unboxing & Setup video guide on Amazon for detailed setup instructions and methods for connecting to the Internet.
  • 【Pocket-friendly】Lightweight design(145g) which designed for your next trip or adventure. Alongside its portable, compact design makes it easy to take with you on the go.
  • 【Full Gigabit Ports】Gigabit Wireless Internet Router with 2 Gigabit LAN ports and 1 Gigabit WAN ports, ideal for lots of internet plan and allow you to connect your wired devices directly.
  • 【Keep your Internet Safe】IPv6 supported. OpenVPN & WireGuard pre-installed, compatible with 30+ VPN service providers. Cloudflare encryption supported to protect the privacy.

3. Route each protected app through Gluetun

Set the app’s network_mode to "service:gluetun". Apply this to every container you want covered. Check the full Compose configuration for any separate network path that would let an app bypass Gluetun.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

4. Publish app ports on Gluetun

For a web interface or other port exposed from a container sharing Gluetun’s network stack, put the Compose ports mapping on the Gluetun service, not on the child app service. In the example, 8080:8080 is only an example mapping; use the app’s actual port and publish it only if needed.

Rank #3
Sale
ASUS RT-AX1800S Dual Band WiFi 6 Extendable Router, Subscription-Free Network Security, Parental Control, Built-in VPN, AiMesh Compatible, Gaming & Streaming, Smart Home
  • New-Gen WiFi Standard – WiFi 6(802.11ax) standard supporting MU-MIMO and OFDMA technology for better efficiency and throughput.Antenna : External antenna x 4. Processor : Dual-core (4 VPE). Power Supply : AC Input : 110V~240V(50~60Hz), DC Output : 12 V with max. 1.5A current.
  • Ultra-fast WiFi Speed – RT-AX1800S supports 1024-QAM for dramatically faster wireless connections
  • Increase Capacity and Efficiency – Supporting not only MU-MIMO but also OFDMA technique to efficiently allocate channels, communicate with multiple devices simultaneously
  • 5 Gigabit ports – One Gigabit WAN port and four Gigabit LAN ports, 10X faster than 100–Base T Ethernet.
  • Commercial-grade Security Anywhere – Protect your home network with AiProtection Classic, powered by Trend Micro. And when away from home, ASUS Instant Guard gives you a one-click secure VPN.

Allow access to a LAN only when needed

By default, the firewall is intended to keep outbound traffic on the VPN path. If a protected app must reach a local device or another specific subnet, add the smallest necessary range using FIREWALL_OUTBOUND_SUBNETS. This exception permits Gluetun and containers sharing its network to reach the specified subnet, so do not add broad private ranges without a clear need.

Make sure an allowed subnet does not overlap the VPN tunnel’s address range. Gluetun warns that overlap can misroute VPN-related traffic and disrupt port forwarding. The firewall options documentation also explains that when a hostname resolves to a private IP in an allowed outbound subnet, it may need to be added to DNS_REBINDING_PROTECTION_EXEMPT_HOSTNAMES.

Rank #4
Sale
GL.iNet GL-BE3600 Slate 7 Wi-Fi 7 Travel Router Touchscreen 2.5G
  • 【DUAL BAND WIFI 7 TRAVEL ROUTER】Products with US, UK, EU, AU Plug; Dual band network with wireless speed 688Mbps (2.4G)+2882Mbps (5G); Dual 2.5G Ethernet Ports (1x WAN and 1x LAN Port); USB 3.0 port.
  • 【NETWORK CONTROL WITH TOUCHSCREEN SIMPLICITY】Slate 7’s touchscreen interface lets you scan QR codes for quick Wi-Fi, monitor speed in real time, toggle VPN on/off, and switch providers directly on the display. Color-coded indicators provide instant network status updates for Ethernet, Tethering, Repeater, and Cellular modes, offering a seamless, user-friendly experience.
  • 【OpenWrt 23.05 FIRMWARE】The Slate 7 (GL-BE3600) is a high-performance Wi-Fi 7 travel router, built with OpenWrt 23.05 (Kernel 5.4.213) for maximum customization and advanced networking capabilities. With 512MB storage, total customization with open-source freedom and flexible installation of OpenWrt plugins.
  • 【VPN CLIENT & SERVER】OpenVPN and WireGuard are pre-installed, compatible with 30+ VPN service providers (active subscription required). Simply log in to your existing VPN account with our portable wifi device, and Slate 7 automatically encrypts all network traffic within the connected network. Max. VPN speed of 100 Mbps (OpenVPN); 540 Mbps (WireGuard). *Speed tests are conducted on a local network. Real-world speeds may differ depending on your network configuration.*
  • 【PERFECT PORTABLE WIFI ROUTER FOR TRAVEL】The Slate 7 is an ideal portable internet device perfect for international travel. With its mini size and travel-friendly features, the pocket Wi-Fi router is the perfect companion for travelers in need of a secure internet connectivity on the go in which includes hotels or cruise ships.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Know which kind of port forwarding you need

Docker port publishing and VPN-provider port forwarding solve different problems. A Compose mapping on Gluetun makes an app port reachable through the Docker host’s published port. VPN-provider forwarding opens a port through the VPN provider’s network; publishing a Docker port alone does not request that provider-side forwarding.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Gluetun documents native VPN-side forwarding for Private Internet Access and ProtonVPN using VPN_PORT_FORWARDING=on. For a designated forwarded port with a provider that does not use Gluetun’s native integration, the documentation describes FIREWALL_VPN_INPUT_PORTS as the firewall allowance for that port. Follow the current provider-specific instructions in the port-forwarding guide; an input allowance is not itself a request for a provider to forward a port.

Best Value
Sale
TP-Link Dual-Band AX3000 Wi-Fi 6 Wireless Gigabit Internet Router for Home
  • Next-Gen Gigabit Wi-Fi 6 Speeds: 2402 Mbps on 5 GHz and 574 Mbps on 2.4 GHz bands ensure smoother streaming and faster downloads; support VPN server and VPN client¹
  • A More Responsive Experience: Enjoy smooth gaming, video streaming, and live feeds simultaneously. OFDMA makes your Wi-Fi stronger by allowing multiple clients to share one band at the same time, cutting latency and jitter.²
  • Expanded Wi-Fi Coverage: 4 high-gain external antennas and Beamforming technology combine to extend strong, reliable, Wi-Fi throughout your home.
  • Improved Battery Life: Target Wake Time helps your devices to communicate efficiently while consuming less power.
  • Improved Cooling Design: No heat ups, no throttles. A larger heat sink and redefined case design cools the WiFi 6 system and enables your network to stay at top speeds in more versatile environments.

Troubleshoot the common failures

  • An app still has internet access when it should be routed through Gluetun: confirm its network mode is "service:gluetun" and inspect the Compose configuration for another network path.
  • A web UI is unreachable: check that its port mapping is on the Gluetun service. Then check whether the intended access path also requires an appropriate firewall input exception.
  • A local device or service cannot be reached: identify the specific subnet the app needs and allow that range with FIREWALL_OUTBOUND_SUBNETS. If a private hostname resolves to an allowed private IP, check the DNS rebinding exemption option.
  • VPN port forwarding stops working after adding a subnet exception: check whether the allowed subnet overlaps the VPN tunnel address range; Gluetun documents that this can cause misrouting and forwarding failures.
  • A port-forward rule has no effect: establish whether you need Docker host-to-container publishing or a port forwarded by the VPN provider, then configure the corresponding mechanism.

What Gluetun’s timing figures do—and do not—show

The Gluetun FAQ reports that firewall setup takes about 15 milliseconds from container start and that setting the firewall rules itself takes 10 milliseconds. The FAQ does not state a publication date for these figures. They are project documentation timing claims, not independent performance tests or measurements of leak-prevention reliability. The inspected documentation does not establish a leak rate or security-outcome statistic.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
Outdated Drivers Are Slowing You DownFree scan - exact matches
PC Slower Than It Used to Be?Free scan - under a minute

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.