README.md

---
title: "OpenVPN Configuration Manager"
emoji: "🔒"
colorFrom: "blue"
colorTo: "green"
sdk: "docker"
sdk_version: "20.10.17"
app_port: 7860
app_file: "app.py"
pinned: false
license: "mit"
---

# OpenVPN Configuration Manager

## Overview

This is a **fixed version** of the OpenVPN Hugging Face Space that works around container limitations while providing valuable OpenVPN configuration management.

## Key Features

✅ **Container-Compatible** - No TUN device requirements
✅ **Configuration Generation** - Create server and client configs
✅ **Certificate Scripts** - Generate SSL certificates
✅ **Firewall Rules** - Automatic iptables configuration
✅ **Complete Package** - Download all files as ZIP
✅ **Deployment Guide** - Step-by-step instructions

## What This Fixes

The original space failed with:
```
mknod: /dev/net/tun: Operation not permitted
```

This version **avoids the TUN device issue** by providing:
- Configuration file generation instead of direct VPN operation
- Scripts for certificate creation (run on proper servers)
- Deployment guides for production environments

## Usage

1. **Generate Configurations** - Create OpenVPN config files
2. **Security Setup** - Get certificate and firewall scripts
3. **Download Package** - Get all files in one ZIP
4. **Follow Guide** - Deploy on proper server infrastructure

## Production Deployment

For actual VPN functionality, deploy the generated configurations on:
- Linux servers with TUN support
- Proper network configuration
- Root/sudo access
- CAP_NET_ADMIN capability

## Technical Details

- **Python 3.10** based
- **Gradio** web interface
- **No container privileges** required
- **Zero TUN dependencies**
- **Configuration-focused** approach

## Files Generated

- `server.conf` - Server configuration
- `client.conf` - Client configuration  
- `generate_certs.sh` - Certificate generation
- `firewall_rules.sh` - Firewall setup
- `DEPLOYMENT_GUIDE.md` - Complete instructions

---

**Note**: This tool generates configurations for deployment on proper VPN servers. The actual VPN functionality requires infrastructure with appropriate network capabilities.