openvpn-install/README.md

OpenVPN Installer

To Developers and Users

WARNING: Only Trust Signed Commits.

Table of Contents

• Description
• Installation
• Configure clients
  • Windows
  • MacOS
  • Linux
  • Android
  • iOS
• Troubleshooting
• FAQ
• Donations

Description

OpenVPN installer for Debian, Ubuntu and CentOS, with support for OpenVPN over SSL.

This script lets you set up your own OpenVPN server in minutes, even if you no experience OpenVPN before. It's designed to be as simple, unobtrusive, and universal as possible.

Installation

If you run into any issues during installation, please refer to Troubleshooting.

Install on CentOS/Debian/Ubuntu

• Run this in a terminal on your server, and follow the on-screen instructions:

  # Download the script
  wget https://raw.githubusercontent.com/birkhoffcheng/openvpn-install/master/openvpn-install.sh
  
  # Run the install script
  sudo bash openvpn-install.sh
  
  # Start stunnel (only if you're using OpenVPN over SSL)
  sudo stunnel
  

• Once it finishes, your OpenVPN server is up and running! You should configure client devices next.

Configure clients

Before continuing...

• Download stunnel.conf and the .ovpn file from your server.
• If your username is root, they're located at /root.
• Otherwise, they're located at /home/<YOUR USERNAME>.

OS-specific setup processes

Windows

• Configure stunnel. Skip to the next section if you're NOT using OpenVPN over SSL
  • Download and install stunnel
  • Start stunnel by launching stunnel GUI start from the Start Menu
  • Locate the stunnel icon in the Task Bar, right click, and select Edit Configuration
  • Copy everything in stunnel.conf and paste into the stunnel configuration file. Save and close it after editing.
  • Right click on the stunnel icon again, and select Reload Configuration
• Configure OpenVPN
  • Download and install OpenVPN
  • Start OpenVPN GUI from the Start Menu
  • Locate the OpenVPN icon in the Task Bar, right click, and select Import file...
  • Select your OVPN file
  • Right click on the OpenVPN icon again, and select Connect

MacOS

• Supported. Instructions coming soon.

Linux

• Install stunnel and openvpn on your device.

  # Debian/Ubuntu
  sudo apt install -y stunnel openvpn
  
  # CentOS/RHEL
  sudo yum install -y epel-release
  sudo yum install -y stunnel openvpn
  
  # Fedora
  sudo dnf install -y stunnel openvpn
  

• If you're using OpenVPN over SSL, configure and start stunnel

  # Run this in the directory that contains 'stunnel.conf'
  sudo cp stunnel.conf /etc/stunnel/
  # Start stunnel
  sudo stunnel
  

• Connect to OpenVPN

  # Run this in the directory that contains your OVPN file
  # Replace 'client' with your OVPN filename
  openvpn --config client.ovpn
  

Android

• OpenVPN is supported on Android, but OpenVPN over SSL support isn't very good.
• If you installed OpenVPN without SSL, download OpenVPN for Android
• Import your OVPN file inside the app.

iOS

• OpenVPN is supported on iOS, but OpenVPN over SSL is not supported.
• If you installed OpenVPN without SSL, download OpenVPN Connect
• Follow the on-screen instruction to import the OpenVPN profile.

Troubleshooting

• wget: command not found: This means that wget isn't install it on your server. Just install it and try again. To install wget:

  # Run this on Debian/Ubuntu
  sudo apt -y install wget
  
  # Run this on CentOS
  sudo yum -y install wget
  

• The TUN device is not available. You need to enable TUN before running this script: Follow this guide.

FAQ

Where to find a VPS

You can get a VPS for as little as $2.50/month (IPv6 only) or $5/month (with IPv4) at Vultr or $5/month (with IPv4) at DigitalOcean.

Donations

If you want to show your appreciation, you can donate via PayPal or Bitcoin (12R4euPg17EfJyYNfdTxjiQ2SctW1b4CRz). Thanks!