Skip to content

Repository files navigation

OpenVPN for Docker

version Docker Stars Docker Pulls last commit commit activity issues pull_requests_closed

OpenVPN server in a Docker container complete with an EasyRSA PKI CA.

Dockerfile and config forked from a no longer maintained kylemanna/docker-openvpn GitHub repo.

Upstream Links

Deprecations

Note that iptables-legacy is no longer supported by this repository.

Release Process

There are three Docker tags used for every new container image build using GitHub workflows:

  1. ${OPENVPN_VERSION}
  2. ${OPENVPN_VERSION}-build${BUILD_ID}
  3. latest

Each build includes the OpenVPN version tag that the image was built with, e.g. 2.6.6. This image, however, gets updated with every pull request, meaning that it's still a moving target for a given version of OpenVPN.

In order to preserve builds across pulls requests, each release also includes a build ID, e.g. 2.6.6-build12, which does not get overwritten. If you want to use a specific version of the OpenVPN image that does not change, use this tag.

Finally, each new build updates the latest tag, meaning that if you want to use the latest version of the OpenVPN image including all latest code changes, then you should use this tag.

How to Build Locally

docker build --pull --no-cache -t lisenet/openvpn:latest .

How to Deploy

The following deployment methods are supported and tested:

If you would like to contribute and provide instructions for other deployment methods (e.g. Podman, Docker engine, Swarm etc), please consider raising a pull request.

Tested On

  • OpenVPN server deployment:
    • Kubernetes 1.28 on Rocky 9 (QEMU/KVM).
    • Kubernetes 1.26 on Rocky 8 (QEMU/KVM).
    • Docker Engine 29.5.3 with Docker Compose plugin 5.1.4 on Ubuntu 24.04 (VMware).
  • Clients:
    • Android App OpenVPN Connect 3.3.4 (9290).
    • OpenVPN 2.5.9 on Rocky 9.
    • OpenVPN 2.4.12 on Rocky 8.
    • OpenVPN 2.4.7 on Debian 10.
    • OpenVPN 2.5.5 on Ubuntu 22.04 LTS.
    • OpenVPN 2.4.7 on Ubuntu 20.04 LTS.
    • OpenVPN Connect 3.8.1 on macOS 15.7.4.

Contributing

CONTRIBUTING

License

LICENSE

About

OpenVPN server in a Docker container.

Resources

Contributing

Stars

35 stars

Watchers

2 watching

Forks

Releases

Sponsor this project

Used by

Contributors

Languages