fix(setup): add now required --device /dev/net/run

qdm12 · Oct 28, 2024 · 0ef8189 · NoobOfAll · Nov 3, 2024 · NoobOfAll
1 parent fbc589e
commit 0ef8189
Show file tree

Hide file tree

Showing 29 changed files with 120 additions and 33 deletions.
diff --git a/contributing/development.md b/contributing/development.md
@@ -104,7 +104,7 @@ You can also do this through IDE such as [VS Code source control](https://code.v
 1. Run it with:
 
     ```sh
-    docker run -it --rm --cap-add=NET_ADMIN \
+    docker run -it --rm --cap-add=NET_ADMIN --device /dev/net/run \
       -e VPN_SERVICE_PROVIDER=someprovider \
       -e VPN_TYPE=openvpn \
       -e OPENVPN_USER=test -e OPENVPN_PASSWORD=test \

diff --git a/setup/inter-containers-networking.md b/setup/inter-containers-networking.md
@@ -75,6 +75,7 @@ The current workaround is to use an IP address to reach `B`:
     services:
       gluetun:
         image: qmcgaw/gluetun
+        # ...
         networks:
           gluetun_network:
 

diff --git a/setup/openvpn-configuration-file.md b/setup/openvpn-configuration-file.md
@@ -25,7 +25,7 @@ In the following we assume your custom openvpn configuration file is named `cust
 1. Run the container for example with:
 
     ```sh
-    docker run -it --rm --cap-add=NET_ADMIN -e VPN_SERVICE_PROVIDER=custom -e OPENVPN_CUSTOM_CONFIG=/gluetun/custom.conf -v /yourpath/custom.conf:/gluetun/custom.conf:ro -e OPENVPN_USER="youruser" -e OPENVPN_PASSWORD="yourpassword" qmcgaw/gluetun
+    docker run -it --rm --cap-add=NET_ADMIN --device /dev/net/run -e VPN_SERVICE_PROVIDER=custom -e OPENVPN_CUSTOM_CONFIG=/gluetun/custom.conf -v /yourpath/custom.conf:/gluetun/custom.conf:ro -e OPENVPN_USER="youruser" -e OPENVPN_PASSWORD="yourpassword" qmcgaw/gluetun
     ```
 
 ## Implicit behavior

diff --git a/setup/port-mapping.md b/setup/port-mapping.md
@@ -16,6 +16,8 @@ services:
     container_name: gluetun
     cap_add:
       - NET_ADMIN
+    devices:
+      - /dev/net/tun:/dev/net/tun
     environment:
       - OPENVPN_USER=js89ds7
       - OPENVPN_PASSWORD=8fd9s239G

diff --git a/setup/providers/airvpn.md b/setup/providers/airvpn.md
@@ -5,7 +5,8 @@
 ### Wireguard
 
 ```sh
-docker run -it --rm --cap-add=NET_ADMIN -e VPN_SERVICE_PROVIDER=airvpn \
+docker run -it --rm --cap-add=NET_ADMIN --device /dev/net/run \
+  -e VPN_SERVICE_PROVIDER=airvpn \
   -e VPN_TYPE=wireguard \
   -e WIREGUARD_PRIVATE_KEY=yCbHtKAgJASnJs2S/aZsjag9Fy04csmR4qDUDkJgX2c= \
   -e WIREGUARD_PRESHARED_KEY=yCbHtKAgJASnJs2S/aZsjag9Fy04csmR4qDUDkJgX2c= \
@@ -20,6 +21,8 @@ services:
     image: qmcgaw/gluetun
     cap_add:
       - NET_ADMIN
+    devices:
+      - /dev/net/tun:/dev/net/tun
     environment:
       - VPN_SERVICE_PROVIDER=airvpn
       - VPN_TYPE=wireguard
@@ -37,7 +40,8 @@ services:
 1. [Setup your client certificate](../advanced/openvpn-client-certificate.md)
 
 ```sh
-docker run -it --rm --cap-add=NET_ADMIN -e VPN_SERVICE_PROVIDER=airvpn \
+docker run -it --rm --cap-add=NET_ADMIN --device /dev/net/run \
+  -e VPN_SERVICE_PROVIDER=airvpn \
   -v /yourpath:/gluetun \
   -e SERVER_COUNTRIES=Netherlands \
   qmcgaw/gluetun
@@ -50,6 +54,8 @@ services:
     image: qmcgaw/gluetun
     cap_add:
       - NET_ADMIN
+    devices:
+      - /dev/net/tun:/dev/net/tun
     environment:
       - VPN_SERVICE_PROVIDER=airvpn
       - SERVER_COUNTRIES=Netherlands

diff --git a/setup/providers/custom.md b/setup/providers/custom.md
@@ -21,6 +21,8 @@ services:
     image: qmcgaw/gluetun
     cap_add:
       - NET_ADMIN
+    devices:
+      - /dev/net/tun:/dev/net/tun
     volumes:
       - ./yourovpnconfig.conf:/gluetun/custom.conf:ro
     environment:
@@ -50,6 +52,8 @@ services:
     image: qmcgaw/gluetun
     cap_add:
       - NET_ADMIN
+    devices:
+      - /dev/net/tun:/dev/net/tun
     environment:
       - VPN_SERVICE_PROVIDER=custom
       - VPN_TYPE=wireguard

diff --git a/setup/providers/cyberghost.md b/setup/providers/cyberghost.md
@@ -6,7 +6,8 @@
 1. [Setup your client certificate](../advanced/openvpn-client-certificate.md)
 
 ```sh
-docker run -it --rm --cap-add=NET_ADMIN -e VPN_SERVICE_PROVIDER=cyberghost \
+docker run -it --rm --cap-add=NET_ADMIN --device /dev/net/run \
+-e VPN_SERVICE_PROVIDER=cyberghost \
 -e OPENVPN_USER=abc -e OPENVPN_PASSWORD=abc \
 -v /yourpath:/gluetun \
 -e SERVER_COUNTRIES=Netherlands qmcgaw/gluetun
@@ -19,6 +20,8 @@ services:
     image: qmcgaw/gluetun
     cap_add:
       - NET_ADMIN
+    devices:
+      - /dev/net/tun:/dev/net/tun
     environment:
       - VPN_SERVICE_PROVIDER=cyberghost
       - OPENVPN_USER=abc

diff --git a/setup/providers/expressvpn.md b/setup/providers/expressvpn.md
@@ -3,7 +3,8 @@
 ## TLDR
 
 ```sh
-docker run -it --rm --cap-add=NET_ADMIN -e VPN_SERVICE_PROVIDER=expressvpn \
+docker run -it --rm --cap-add=NET_ADMIN --device /dev/net/run \
+-e VPN_SERVICE_PROVIDER=expressvpn \
 -e OPENVPN_USER=abc -e OPENVPN_PASSWORD=abc \
 -e SERVER_COUNTRIES=Netherlands qmcgaw/gluetun
 ```
@@ -15,6 +16,8 @@ services:
     image: qmcgaw/gluetun
     cap_add:
       - NET_ADMIN
+    devices:
+      - /dev/net/tun:/dev/net/tun
     environment:
       - VPN_SERVICE_PROVIDER=expressvpn
       - OPENVPN_USER=abc

diff --git a/setup/providers/fastestvpn.md b/setup/providers/fastestvpn.md
@@ -4,14 +4,16 @@
 
 ```sh
 # OpenVPN
-docker run -it --rm --cap-add=NET_ADMIN -e VPN_SERVICE_PROVIDER=fastestvpn \
+docker run -it --rm --cap-add=NET_ADMIN --device /dev/net/run \
+-e VPN_SERVICE_PROVIDER=fastestvpn \
 -e OPENVPN_USER=abc -e OPENVPN_PASSWORD=abc \
 -e SERVER_COUNTRIES=Netherlands qmcgaw/gluetun
 ```
 
 ```sh
 # Wireguard
-docker run -it --rm --cap-add=NET_ADMIN -e VPN_SERVICE_PROVIDER=fastestvpn \
+docker run -it --rm --cap-add=NET_ADMIN --device /dev/net/run \
+-e VPN_SERVICE_PROVIDER=fastestvpn \
 -e VPN_TYPE=wireguard \
 -e WIREGUARD_PRIVATE_KEY=wOEI9rqqbDwnN8/Bpp22sVz48T71vJ4fYmFWujulwUU= \
 -e WIREGUARD_ADDRESSES="10.64.222.21/32" \
@@ -25,6 +27,8 @@ services:
     image: qmcgaw/gluetun
     cap_add:
       - NET_ADMIN
+    devices:
+      - /dev/net/tun:/dev/net/tun
     environment:
       - VPN_SERVICE_PROVIDER=fastestvpn
       - VPN_TYPE=wireguard

diff --git a/setup/providers/hidemyass.md b/setup/providers/hidemyass.md
@@ -3,7 +3,8 @@
 ## TLDR
 
 ```sh
-docker run -it --rm --cap-add=NET_ADMIN -e VPN_SERVICE_PROVIDER=hidemyass \
+docker run -it --rm --cap-add=NET_ADMIN --device /dev/net/run \
+-e VPN_SERVICE_PROVIDER=hidemyass \
 -e OPENVPN_USER=abc -e OPENVPN_PASSWORD=abc \
 -e SERVER_COUNTRIES=Netherlands qmcgaw/gluetun
 ```
@@ -15,6 +16,8 @@ services:
     image: qmcgaw/gluetun
     cap_add:
       - NET_ADMIN
+    devices:
+      - /dev/net/tun:/dev/net/tun
     environment:
       - VPN_SERVICE_PROVIDER=hidemyass
       - OPENVPN_USER=abc

diff --git a/setup/providers/ipvanish.md b/setup/providers/ipvanish.md
@@ -3,7 +3,8 @@
 ## TLDR
 
 ```sh
-docker run -it --rm --cap-add=NET_ADMIN -e VPN_SERVICE_PROVIDER=ipvanish \
+docker run -it --rm --cap-add=NET_ADMIN --device /dev/net/run \
+-e VPN_SERVICE_PROVIDER=ipvanish \
 -e OPENVPN_USER=abc -e OPENVPN_PASSWORD=abc \
 -e SERVER_COUNTRIES=Netherlands qmcgaw/gluetun
 ```
@@ -15,6 +16,8 @@ services:
     image: qmcgaw/gluetun
     cap_add:
       - NET_ADMIN
+    devices:
+      - /dev/net/tun:/dev/net/tun
     environment:
       - VPN_SERVICE_PROVIDER=ipvanish
       - OPENVPN_USER=abc

diff --git a/setup/providers/ivpn.md b/setup/providers/ivpn.md
@@ -4,14 +4,16 @@
 
 ```sh
 # OpenVPN
-docker run -it --rm --cap-add=NET_ADMIN -e VPN_SERVICE_PROVIDER=ivpn \
+docker run -it --rm --cap-add=NET_ADMIN --device /dev/net/run \
+-e VPN_SERVICE_PROVIDER=ivpn \
 -e VPN_TYPE=openvpn -e OPENVPN_USER=abc -e OPENVPN_PASSWORD=abc \
 -e SERVER_CITIES=amsterdam qmcgaw/gluetun
 ```
 
 ```sh
 # Wireguard
-docker run -it --rm --cap-add=NET_ADMIN -e VPN_SERVICE_PROVIDER=ivpn \
+docker run -it --rm --cap-add=NET_ADMIN --device /dev/net/run \
+-e VPN_SERVICE_PROVIDER=ivpn \
 -e VPN_TYPE=wireguard \
 -e WIREGUARD_PRIVATE_KEY=wOEI9rqqbDwnN8/Bpp22sVz48T71vJ4fYmFWujulwUU= \
 -e WIREGUARD_ADDRESSES="10.64.222.21/32" \
@@ -25,6 +27,8 @@ services:
     image: qmcgaw/gluetun
     cap_add:
       - NET_ADMIN
+    devices:
+      - /dev/net/tun:/dev/net/tun
     environment:
       - VPN_SERVICE_PROVIDER=ivpn
       - VPN_TYPE=wireguard

diff --git a/setup/providers/mullvad.md b/setup/providers/mullvad.md
@@ -4,14 +4,16 @@
 
 ```sh
 # OpenVPN
-docker run -it --rm --cap-add=NET_ADMIN -e VPN_SERVICE_PROVIDER=mullvad \
+docker run -it --rm --cap-add=NET_ADMIN --device /dev/net/run \
+-e VPN_SERVICE_PROVIDER=mullvad \
 -e VPN_TYPE=openvpn -e OPENVPN_USER=1355131650462193 \
 -e SERVER_CITIES=amsterdam qmcgaw/gluetun
 ```
 
 ```sh
 # Wireguard
-docker run -it --rm --cap-add=NET_ADMIN -e VPN_SERVICE_PROVIDER=mullvad \
+docker run -it --rm --cap-add=NET_ADMIN --device /dev/net/run \
+-e VPN_SERVICE_PROVIDER=mullvad \
 -e VPN_TYPE=wireguard \
 -e WIREGUARD_PRIVATE_KEY=wOEI9rqqbDwnN8/Bpp22sVz48T71vJ4fYmFWujulwUU= \
 -e WIREGUARD_ADDRESSES="10.64.222.21/32" \
@@ -25,6 +27,8 @@ services:
     image: qmcgaw/gluetun
     cap_add:
       - NET_ADMIN
+    devices:
+      - /dev/net/tun:/dev/net/tun
     environment:
       - VPN_SERVICE_PROVIDER=mullvad
       - VPN_TYPE=wireguard

diff --git a/setup/providers/nordvpn.md b/setup/providers/nordvpn.md
@@ -4,7 +4,8 @@
 
 ```sh
 # OpenVPN
-docker run -it --rm --cap-add=NET_ADMIN -e VPN_SERVICE_PROVIDER=nordvpn \
+docker run -it --rm --cap-add=NET_ADMIN --device /dev/net/run \
+-e VPN_SERVICE_PROVIDER=nordvpn \
 -e OPENVPN_USER=abc -e OPENVPN_PASSWORD=abc \
 -e SERVER_COUNTRIES=Netherlands qmcgaw/gluetun
 ```
@@ -13,7 +14,8 @@ docker run -it --rm --cap-add=NET_ADMIN -e VPN_SERVICE_PROVIDER=nordvpn \
 
 ```sh
 # Wireguard
-docker run -it --rm --cap-add=NET_ADMIN -e VPN_SERVICE_PROVIDER=nordvpn \
+docker run -it --rm --cap-add=NET_ADMIN --device /dev/net/run \
+-e VPN_SERVICE_PROVIDER=nordvpn \
 -e VPN_TYPE=wireguard \
 -e WIREGUARD_PRIVATE_KEY=wOEI9rqqbDwnN8/Bpp22sVz48T71vJ4fYmFWujulwUU= \
 -e SERVER_COUNTRIES=Netherlands qmcgaw/gluetun
@@ -28,6 +30,8 @@ services:
     image: qmcgaw/gluetun
     cap_add:
       - NET_ADMIN
+    devices:
+      - /dev/net/tun:/dev/net/tun
     environment:
       - VPN_SERVICE_PROVIDER=nordvpn
       - VPN_TYPE=openvpn # or wireguard

diff --git a/setup/providers/perfect-privacy.md b/setup/providers/perfect-privacy.md
@@ -3,7 +3,8 @@
 ## TLDR
 
 ```sh
-docker run -it --rm --cap-add=NET_ADMIN -e VPN_SERVICE_PROVIDER="perfect privacy" \
+docker run -it --rm --cap-add=NET_ADMIN --device /dev/net/run \
+-e VPN_SERVICE_PROVIDER="perfect privacy" \
 -e OPENVPN_USER=abc -e OPENVPN_PASSWORD=abc \
 -e SERVER_CITIES=Amsterdam qmcgaw/gluetun
 ```
@@ -15,6 +16,8 @@ services:
     image: qmcgaw/gluetun
     cap_add:
       - NET_ADMIN
+    devices:
+      - /dev/net/tun:/dev/net/tun
     environment:
       - VPN_SERVICE_PROVIDER=perfect privacy
       - OPENVPN_USER=abc

diff --git a/setup/providers/privado.md b/setup/providers/privado.md
@@ -3,7 +3,8 @@
 ## TLDR
 
 ```sh
-docker run -it --rm --cap-add=NET_ADMIN -e VPN_SERVICE_PROVIDER=privado \
+docker run -it --rm --cap-add=NET_ADMIN --device /dev/net/run \
+-e VPN_SERVICE_PROVIDER=privado \
 -e OPENVPN_USER=abc -e OPENVPN_PASSWORD=abc \
 -e SERVER_COUNTRIES=Netherlands qmcgaw/gluetun
 ```
@@ -15,6 +16,8 @@ services:
     image: qmcgaw/gluetun
     cap_add:
       - NET_ADMIN
+    devices:
+      - /dev/net/tun:/dev/net/tun
     environment:
       - VPN_SERVICE_PROVIDER=privado
       - OPENVPN_USER=abc

diff --git a/setup/providers/private-internet-access.md b/setup/providers/private-internet-access.md
@@ -3,7 +3,8 @@
 ## OpenVPN
 
 ```sh
-docker run -it --rm --cap-add=NET_ADMIN -e VPN_SERVICE_PROVIDER="private internet access" \
+docker run -it --rm --cap-add=NET_ADMIN --device /dev/net/run \
+-e VPN_SERVICE_PROVIDER="private internet access" \
 -e OPENVPN_USER=abc -e OPENVPN_PASSWORD=abc \
 -v /yourpath/gluetun:/gluetun \
 -e SERVER_REGIONS=Netherlands qmcgaw/gluetun
@@ -16,6 +17,8 @@ services:
     image: qmcgaw/gluetun
     cap_add:
       - NET_ADMIN
+    devices:
+      - /dev/net/tun:/dev/net/tun
     volumes:
       - ./gluetun:/gluetun
     environment:

diff --git a/setup/providers/privatevpn.md b/setup/providers/privatevpn.md
@@ -7,7 +7,8 @@
 For OpenVPN:
 
 ```sh
-docker run -it --rm --cap-add=NET_ADMIN -e VPN_SERVICE_PROVIDER=privatevpn \
+docker run -it --rm --cap-add=NET_ADMIN --device /dev/net/run \
+-e VPN_SERVICE_PROVIDER=privatevpn \
 -e OPENVPN_USER=abc -e OPENVPN_PASSWORD=abc \
 -e SERVER_COUNTRIES=Netherlands qmcgaw/gluetun
 ```
@@ -19,6 +20,8 @@ services:
     image: qmcgaw/gluetun
     cap_add:
       - NET_ADMIN
+    devices:
+      - /dev/net/tun:/dev/net/tun
     environment:
       - VPN_SERVICE_PROVIDER=privatevpn
       - OPENVPN_USER=abc

diff --git a/setup/providers/protonvpn.md b/setup/providers/protonvpn.md
@@ -4,14 +4,16 @@
 
 ```sh
 # OpenVPN
-docker run -it --rm --cap-add=NET_ADMIN -e VPN_SERVICE_PROVIDER=protonvpn \
+docker run -it --rm --cap-add=NET_ADMIN --device /dev/net/run \
+-e VPN_SERVICE_PROVIDER=protonvpn \
 -e OPENVPN_USER=abc -e OPENVPN_PASSWORD=abc \
 -e SERVER_COUNTRIES=Netherlands qmcgaw/gluetun
 ```
 
 ```sh
 # Wireguard
-docker run -it --rm --cap-add=NET_ADMIN -e VPN_SERVICE_PROVIDER=protonvpn \
+docker run -it --rm --cap-add=NET_ADMIN --device /dev/net/run \
+-e VPN_SERVICE_PROVIDER=protonvpn \
 -e VPN_TYPE=wireguard \
 -e WIREGUARD_PRIVATE_KEY=wOEI9rqqbDwnN8/Bpp22sVz48T71vJ4fYmFWujulwUU= \
 -e SERVER_COUNTRIES=Netherlands qmcgaw/gluetun
@@ -24,6 +26,8 @@ services:
     image: qmcgaw/gluetun
     cap_add:
       - NET_ADMIN
+    devices:
+      - /dev/net/tun:/dev/net/tun
     environment:
       - VPN_SERVICE_PROVIDER=protonvpn
       - VPN_TYPE=wireguard