tldrit/openvpn-mng repository overview

⁠OpenVPN Manager

A web-based management system for OpenVPN users, groups, networks, and access control.

⁠Features

• User Management with RBAC (User, Manager, Admin roles)
• Group-based network access control
• VPN session tracking and statistics
• Time-limited user access (valid_from/valid_to)
• REST API with Swagger documentation
• VPN Auth API for OpenVPN integration
• Audit logging for compliance

⁠Quick Start

⁠Using Docker Run

docker run -d \
  --name openvpn-mng \
  -p 8080:8080 \
  -v /path/to/config.yaml:/app/config.yaml \
  tldrit/openvpn-mng:latest

⁠Using Docker Compose

version: '3.8'
services:
  openvpn-mng:
    image: tldrit/openvpn-mng:latest
    ports:
      - "8080:8080"
    volumes:
      - ./config.yaml:/app/config.yaml
    environment:
      - DB_HOST=postgres
      - DB_PORT=5432
      - DB_USERNAME=openvpn
      - DB_PASSWORD=secret
      - DB_DATABASE=openvpn_mng
      - AUTH_JWT_SECRET=your-secret-here
    depends_on:
      - postgres

  postgres:
    image: postgres:15-alpine
    environment:
      - POSTGRES_USER=openvpn
      - POSTGRES_PASSWORD=secret
      - POSTGRES_DB=openvpn_mng
    volumes:
      - postgres_data:/var/lib/postgresql/data

volumes:
  postgres_data:

⁠Configuration

Configuration can be provided via:

1. Config file mounted at /app/config.yaml
2. Environment variables

⁠Environment Variables

⁠Default Credentials

• Username: admin
• Password: admin123

⚠️ Change the default password immediately after first login!

⁠Supported Architectures

• linux/amd64
• linux/arm64

⁠Tags

• latest - Latest stable release
• x.y.z - Specific version (e.g., 1.0.0)

⁠Documentation

• GitHub Repository⁠
• Installation Guide⁠
• API Documentation⁠
• Client Integration⁠

⁠License

Apache License 2.0

⁠Support

• GitHub Issues⁠