Skip to content

Latest commit

 

History

History
81 lines (66 loc) · 2.43 KB

custom.md

File metadata and controls

81 lines (66 loc) · 2.43 KB

Custom provider

TLDR

OpenVPN

💁 See the Openvpn configuration file page for information on how to set this up.

docker run -it --rm --cap-add=NET_ADMIN \
-e VPN_SERVICE_PROVIDER=custom -e VPN_TYPE=openvpn \
-v /yourpath/yourconfig.conf:/gluetun/config.conf:ro \
-e OPENVPN_CUSTOM_CONFIG=/gluetun/custom.conf \
-e OPENVPN_USER=abc -e OPENVPN_PASSWORD=abc qmcgaw/gluetun
version: "3"
services:
  gluetun:
    image: qmcgaw/gluetun
    cap_add:
      - NET_ADMIN
    volumes:
      - ./yourovpnconfig.conf:/gluetun/custom.conf:ro
    environment:
      - VPN_SERVICE_PROVIDER=custom
      - VPN_TYPE=openvpn
      - OPENVPN_CUSTOM_CONFIG=/gluetun/custom.conf

Wireguard

docker run -it --rm --cap-add=NET_ADMIN \
-e VPN_SERVICE_PROVIDER=custom -e VPN_TYPE=wireguard \
-e WIREGUARD_ENDPOINT_IP=1.2.3.4 \
-e WIREGUARD_ENDPOINT_PORT=51820 \
-e WIREGUARD_PUBLIC_KEY=wAUaJMhAq3NFutLHIdF8AN0B5WG8RndfQKLPTEDHal0= \
-e WIREGUARD_PRIVATE_KEY=wOEI9rqqbDwnN8/Bpp22sVz48T71vJ4fYmFWujulwUU= \
-e WIREGUARD_PRESHARED_KEY=xOEI9rqqbDwnN8/Bpp22sVz48T71vJ4fYmFWujulwUU= \
-e WIREGUARD_ADDRESSES="10.64.222.21/32" \
qmcgaw/gluetun
version: "3"
services:
  gluetun:
    image: qmcgaw/gluetun
    cap_add:
      - NET_ADMIN
    environment:
      - VPN_SERVICE_PROVIDER=custom
      - VPN_TYPE=wireguard
      - WIREGUARD_ENDPOINT_IP=1.2.3.4
      - WIREGUARD_ENDPOINT_PORT=51820
      - WIREGUARD_PUBLIC_KEY=wAUaJMhAq3NFutLHIdF8AN0B5WG8RndfQKLPTEDHal0=
      - WIREGUARD_PRIVATE_KEY=wOEI9rqqbDwnN8/Bpp22sVz48T71vJ4fYmFWujulwUU=
      - WIREGUARD_PRESHARED_KEY=xOEI9rqqbDwnN8/Bpp22sVz48T71vJ4fYmFWujulwUU=
      - WIREGUARD_ADDRESSES=10.64.222.21/32

💁 You can also bind mount a wireguard configuration file (ini format) to /gluetun/wireguard/wg0.conf.

Required environment variables

  • VPN_SERVICE_PROVIDER=custom

OpenVPN only

  • OPENVPN_CUSTOM_CONFIG: Path to your custom configuration file.

Wireguard only

  • WIREGUARD_ENDPOINT_IP: the server endpoint IP address
  • WIREGUARD_ENDPOINT_PORT: the server endpoint port
  • WIREGUARD_PUBLIC_KEY is the server 32 bytes public key in base64 format.
  • WIREGUARD_PRIVATE_KEY is your 32 bytes private key in base64 format.
  • WIREGUARD_ADDRESSES is your IP network interface address in the format xx.xx.xx.xx/xx.
  • WIREGUARD_PRESHARED_KEY is your 32 bytes pre-shared key in base64 format. This is often optional and can be left unset.