- Dockerized WireGuard on Oracle Cloud ☁️ 🐋
This project demonstrates a secure, cloud hosted VPN gateway built with WireGuard and fully containerized with Docker.
It routes all network traffic from a client device through an encrypted WireGuard tunnel on an Oracle Cloud instance, ensuring privacy and secure routing.
This project was designed as a hands on learning experience in cloud security, containerization, and network encryption, showcasing real world applications of SSH, Docker Compose, and Linux CLI workflows.
- End to end encrypted VPN using WireGuard
- Dockerized deployment for portability
- SSH key-based authentication (public/private key pairs)
- Configurable network routing for client devices
- Fully testable on personal hotspot, home, or cloud networks
- Safe GitHub integration with
.gitignoreto protect secrets
| Component | Purpose |
|---|---|
| Oracle Cloud Free Tier | Cloud instance hosting |
| Ubuntu 22.04 LTS | Server OS |
| WireGuard | VPN protocol |
| Docker & Docker Compose | Containerization |
| SSH Keys | Secure authentication |
| GitHub | Version control & repo management |
├── Dockerfile # Docker image definition
├── docker compose.yml # Compose file for container orchestration
├── entrypoint.sh # Startup script for WireGuard container
├── wg0.conf # WireGuard configuration (ignored in git)
├── .gitignore # Files to ignore in Git
└── publickey # WireGuard public key (safe to include)
git clone [email protected]:Code-tech77/wireguard-vpn-gateway.git
cd wireguard-vpn-gatewayssh-keygen -t ed25519 -C "[email protected]"
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519
cat ~/.ssh/id_ed25519.pub
- Tips : Go to GitHub → Settings → SSH and GPG keys → New SSH key → Paste → Save
• Update wg0.conf with your private and public keys
• Ensure AllowedIPs is set to 0.0.0.0/0 to route all traffic
docker-compose build
docker-compose up -d
sudo wg-quick up wg0
• Practical SSH key generation & management
• Hands-on Docker Compose orchestration
• Cloud networking & VPN routing fundamentals
• CLI-driven debugging & container management
• Real-world GitHub workflow with security best practices
My Linkedin => https://www.linkedin.com/in/mohammed-zuoriki-856133250/
Portfolio Sites => https://code-tech77.github.io/new-portfolio/