From 9a7ccd45aee1091edca476e94d1b2db59951aa77 Mon Sep 17 00:00:00 2001 From: Kyle Manna Date: Mon, 30 Jun 2014 00:35:52 -0700 Subject: [PATCH] docs: Add static IP documentation * Add the documentation while it's fresh. --- docs/static-ips.md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 docs/static-ips.md diff --git a/docs/static-ips.md b/docs/static-ips.md new file mode 100644 index 0000000..39ccfe2 --- /dev/null +++ b/docs/static-ips.md @@ -0,0 +1,24 @@ +# Static IP Addresses + +The docker image is setup for static client configuration on the 192.168.254.0/24 subnet. To use it follow the Quick Start section below. Note that the IP addresses octects need to be picked special, see [OpenVPN Documentation](https://openvpn.net/index.php/open-source/documentation/howto.html#policy) for more details. + +## Quick Start + +1. Create a client specific configuration: + + $ echo "ifconfig-push 192.168.254.1 192.168.254.2" | docker run --volumes-from openvpn-data -i --rm kylemanna/openvpn tee /etc/openvpn/ccd/CERT_COMMON_NAME + ifconfig-push 192.168.254.1 192.168.254.2 + +2. Wait for client to reconnect if necessary + +## Advanced Admin + +Login to the openvpn-data volume with a `bash` container, note only changes in /etc/openvpn will persist: + + docker run --volumes-from openvpn-data -it --rm kylemanna/openvpn bash -l + +## Upgrading from Old OpenVPN Configurations + +If you're running an old configuration and need to upgrade it to pull in the ccd directory run the following: + + docker run --volumes-from openvpn-data --rm kylemanna/openvpn ovpn_genconfig