Skip to content

Commit 4d2541d

Browse files
Create README.md
1 parent 65f9d04 commit 4d2541d

File tree

1 file changed

+60
-0
lines changed

1 file changed

+60
-0
lines changed

README.md

+60
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,60 @@
1+
# Ansible VPN Playbook
2+
3+
![Ansible](https://img.shields.io/badge/ansible-%3E%3D2.9-brightgreen.svg) ![License](https://img.shields.io/github/license/javascriptizer1/ansible-vpn)
4+
5+
This Ansible playbook automates the setup of a VPN (Virtual Private Network) server. You can use it to quickly deploy a VPN server for secure and private network connections.
6+
7+
## Table of Contents
8+
9+
- [Prerequisites](#prerequisites)
10+
- [Usage](#usage)
11+
- [Configuration](#configuration)
12+
- [License](#license)
13+
14+
## Prerequisites
15+
16+
Before using this playbook, ensure that you have the following prerequisites in place:
17+
18+
- [Ansible](https://www.ansible.com/) installed on your local machine.
19+
20+
## Usage
21+
22+
1. Clone this repository to your local machine:
23+
24+
```bash
25+
git clone https://github.com/javascriptizer1/ansible-vpn.git
26+
```
27+
28+
2. Navigate to the playbook directory:
29+
30+
```bash
31+
cd ansible-vpn
32+
```
33+
34+
3. Edit the **inventory.ini** file to define your target hosts.
35+
36+
4. Customize the **defaults/main.yaml** file to configure your VPN settings.
37+
38+
5. Run the playbook using the following command:
39+
40+
```bash
41+
ansible-playbook -i inventories/inventory.ini -l vpn playbook.yaml --diff -v -vvvv
42+
```
43+
44+
Follow the prompts and provide any additional information required during the playbook execution.
45+
46+
Once the playbook completes, your VPN server should be up and running.
47+
48+
## Configuration
49+
50+
You can customize your VPN setup by editing the **defaults/main.yaml** file. Here are some of the parameters you can configure:
51+
52+
- VPN server type (OpenVPN, WireGuard, etc.)
53+
- VPN server port
54+
- DNS server settings
55+
- VPN client settings
56+
- Additional server hardening options
57+
58+
## License
59+
60+
None

0 commit comments

Comments
 (0)