Skip to content

0xAhmadYousuf/OVPN-Installer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Success Result

OVPN-Installer

A fully automated Bash script to install and configure an OpenVPN server using Docker on Parrot OS (Debian-based) systems. This script handles Docker installation, OpenVPN setup, and client configuration generation.

Features

  • Cleans up previous Docker installations
  • Installs Docker (native Parrot or Docker CE)
  • Sets up OpenVPN server using the official Docker image
  • Generates client configuration files
  • Easy management commands for your VPN server

Requirements

  • Parrot OS or Debian-based Linux
  • Bash shell
  • Internet connection

Usage

1. Download and Run (One-liner)

Run the following command to download and execute the installer directly:

bash <(curl -sSL https://raw.githubusercontent.com/0xAhmadYousuf/OVPN-Installer/main/installer.sh) -h <your_ip_or_dns>

Replace <your_ip_or_dns> with your server's external IP address or DNS name.

Optional arguments:

  • -c <client_name>: Set client name (default: client1)
  • -d <data_volume>: Set OpenVPN data volume name (default: ovpn-data-docker)

Example:

bash <(curl -sSL https://raw.githubusercontent.com/0xAhmadYousuf/OVPN-Installer/main/installer.sh) -h vpn.example.com -c alice

How to Start

How to Start

2. Script Arguments

Usage: installer.sh -h <ip/host> [-c <client_name>] [-d <data_volume>]
	-h <ip/host>        Required. External IP address or DNS name for OpenVPN server.
	-c <client_name>    Optional. Client name identifier. Default: client1
	-d <data_volume>    Optional. OpenVPN data volume name. Default: ovpn-data-docker
	--help              Show this help message.

What the Script Does

Success Result

Success Result

  1. Cleans up any previous Docker installations
  2. Installs Docker (native Parrot or Docker CE)
  3. Adds your user to the Docker group
  4. Pulls the official OpenVPN Docker image
  5. Generates OpenVPN server configuration
  6. Initializes PKI (you'll set a CA passphrase)
  7. Starts the OpenVPN server container
  8. Generates a client certificate and config file
  9. Outputs the .ovpn file for your client

Managing Your OpenVPN Server

  • Check status: docker ps
  • View logs: docker logs openvpn-server
  • Stop server: docker stop openvpn-server
  • Start server: docker start openvpn-server

Next Steps

  1. Copy the generated <client_name>.ovpn file to your client device
  2. Import it into your OpenVPN client
  3. Connect to your VPN server at <ip/host>:1194

Security

  • The generated .ovpn file contains sensitive credentials. Keep it secure!

License

See LICENSE.

Repository

GitHub: 0xAhmadYousuf/OVPN-Installer just the repo

About

one line ovpn install and start docker

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages