Code Monkey home page Code Monkey logo

pritunl's Introduction

Pritunl Docker Container

Latest Build Status Docker Pulls Docker Stars License

Docker tags:

Tag pritunl Version Description Release Date
latest v1.30.3053.58 Latest stable release 2022-01-21


Description

Pritunl container built on Alpine Linux. Supports IPv6 and running behind a reverse proxy. This container requires an external Mongo DB and should be run via Docker Compose or other orchestration.


Usage

This container exposes the following five ports:

  • 80/tcp pritunl web server http port (standalone mode)
  • 443/tcp pritunl web server https port (standalone and wireguard reverse-proxy mode)
  • 1194/tcp pritunl VPN service port
  • 1194/tcp pritunl OpenVPN service port
  • 1195/udp pritunl wireguard service port - No default in app, this is a suggestion only.
  • 9700/tcp pritunl web server http port (non-wireguard reverse-proxy mode)

Wireguard

The Docker host is required to have wireguard kernel modules installed and loaded.

Wireguard also requires that the pritunl web service exists internally on port 443 with SSL enabled (self-signed or LetsEncrypt cert). Without this clients will fail to connect or connection will time out after 15s in wireguard mode. This presents problems with existing reverse-proxy support using port 9700 and no SSL.

Wireguard + Traefik 1.X reverse-proxy + pritunl SSL self-signed cert:

  • Set InsecureSkipVerify = true in Traefik 1.X traefik.toml config file (configure Traefik to accept invalid/self-signed certs)
  • Set container ENV variable REVERSE_PROXY=true (configure pritunl for reverse-proxy/load-balance mode)
  • Set container ENV variable WIREGUARD=true (configure pritunl to run web interface on port 443 with SSL)

Further pritunl wireguard information available at:


OpenVPN server fails to start, insmod error

ip6tables v1.8.3 (legacy): can't initialize ip6tables table 'filter': Table does not exist (do you need to insmod?) is repeatedly logged in the Docker container log along with python errors.

Load the ip6tables_filter kernel module on your Docker host and restart the container:

user@host:~$ sudo modprobe ip6table_filter
user@host:~$ sudo docker restart pritunl

This may need to be performed after kernel upgrades and reboots on the Docker host.


Basic docker-compose.yml to launch a Mongo DB container instance, pritunl in standalone mode, and make the web and VPN ports accessible

version: '3'

services:
  mongo:
    image: mongo:latest
    container_name: pritunldb
    hostname: pritunldb
    network_mode: bridge
    volumes:
      - ./db:/data/db

  pritunl:
    image: goofball222/pritunl:latest
    container_name: pritunl
    hostname: pritunl
    depends_on:
        - mongo
    network_mode: bridge
    privileged: true
    sysctls:
      - net.ipv6.conf.all.disable_ipv6=0
    links:
      - mongo
    volumes:
      - /etc/localtime:/etc/localtime:ro
    ports:
      - 80:80
      - 443:443
      - 1194:1194
      - 1194:1194/udp
      - 1195:1195/udp
    environment:
      - TZ=UTC

Other/extended docker-compose.yml examples see: https://github.com/goofball222/pritunl/tree/main/examples


Environment variables:

Variable Default Description
DEBUG false Set to true for extra entrypoint script verbosity for debugging
MONGODB_URI mongodb://mongo:27017/pritunl Sets the URI Pritunl will access for the Mongo DB instance
PRITUNL_OPTS unset Any additional custom run options for the container pritunl process
REVERSE_PROXY false Set to true to set the pritunl web interface to run in reverse-proxy mode (Traefik/nginx)
WIREGUARD false Set to true, Switches web interface back to port 443 and HTTPS if running wireguard with reverse-proxy (Traefik/nginx)

pritunl's People

Contributors

goofball222 avatar simonmicro avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.