Repository files navigation

This repository contains Ansible playbooks for the automated deployment and management of an OpenVPN server.

• Overview
• Requirements
• Installation
• Configuration
• Usage
• Important Note
• License

The playbooks in this repository provide a complete automation solution for setting up and managing an OpenVPN server. The suite of scripts handles installation, configuration, and user management, thereby simplifying the server setup process. Additionally, it encapsulates EasyRSA in a Docker container for efficient public key infrastructure (PKI) management.

• Python3
• Pipenv
• Docker
• Server running Debian or Ubuntu.

Clone the repository:

git clone https://github.com/ggragham/openvpn_deploy.git

Navigate into the repository directory:

cd openvpn_deploy/

Install Ansible and dependencies using Pipenv:

pipenv install

Fillinventory.yml andvars.yml from templates:

cp ansible/inventory.yml.template ansible/inventory.ymledit ansible/inventory.ymlcp ansible/vars.yml.template ansible/vars.ymledit ansible/vars.yml

Before running the playbooks, ensure that your Pipenv virtual environment is active:

pipenv shell

Navigate into the ansible directory:

cd ansible/

To deploy an OpenVPN server, use the following command:

ansible-playbook openvpn_deploy.yml

For client management, use the corresponding playbook:

• To add a client:

ansible-playbook openvpn_gen_client.yml -e"client_name=<name>"

• To revoke a client:

ansible-playbook openvpn_revoke_client.yml -e"client_name=<name>"

Don't forget to back up your configuration files and PKI information regularly. This will ensure that you can recover your OpenVPN server setup in case of unforeseen issues. The responsibility for maintaining backups lies with the user.

This software is published under the GPL-3.0 License license.