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