Installation Guide - georgi-dev215/openvpn-web-manager GitHub Wiki

Installation Guide

This guide covers all methods to install OpenVPN Web Manager on your system.

Prerequisites

System Requirements

  • Operating System: Linux (Ubuntu 18.04+, CentOS 7+, Debian 9+)
  • Python: 3.7 or higher
  • Memory: 512MB minimum (1GB+ recommended)
  • Storage: 1GB free space minimum
  • Network: Internet connection for initial setup

Required Software

# Ubuntu/Debian
sudo apt update
sudo apt install python3 python3-pip python3-venv git curl

# CentOS/RHEL
sudo yum install python3 python3-pip git curl

Installation Methods

Method 1: Automated Script (Recommended)

curl -fsSL https://raw.githubusercontent.com/georgi-dev215/openvpn-web-manager/main/install.sh | bash

Method 2: Manual Installation

# 1. Clone repository
git clone https://github.com/georgi-dev215/openvpn-web-manager.git
cd openvpn-web-manager

# 2. Run installation script
chmod +x install.sh
sudo ./install.sh

# 3. Start service
sudo systemctl start openvpn-webmanager
sudo systemctl enable openvpn-webmanager

Method 3: Docker Installation

# Using Docker Compose
git clone https://github.com/georgi-dev215/openvpn-web-manager.git
cd openvpn-web-manager
docker-compose up -d

Post-Installation Setup

  1. Access Web Interface: Navigate to http://your-server-ip:8822
  2. Default Login:
    • Username: admin
    • Password: admin123
  3. Change Password: Go to Settings → Security
  4. Configure OpenVPN: Use the configuration wizard

Verification

# Check service status
sudo systemctl status openvpn-webmanager

# Check logs
sudo journalctl -u openvpn-webmanager -f

# Test web interface
curl http://localhost:8822

Next Steps