Pi Gateway Documentation

Secure remote access gateway for Raspberry Pi. SSH + VPN setup in under 10 minutes.

Quick Links

• Quick Start — Get running in 15 minutes
• Setup Guide — Step-by-step installation
• Guides — Task-focused documentation
• Operations — Daily management and troubleshooting
• Development — Contributing and extending

What is Pi Gateway?

Pi Gateway transforms your Raspberry Pi into a hardened, secure remote access gateway with:

• SSH hardening — Key-based authentication, fail2ban protection
• WireGuard VPN — Encrypted remote access to home network
• Firewall protection — UFW with secure defaults
• System hardening — Security best practices applied

Installation

curl -sSL https://raw.githubusercontent.com/1mb-dev/pi-gateway/main/scripts/quick-install.sh | bash

Features

• ✅ 40/40 tests passing (100%)
• ✅ Security hardening verified
• ✅ Docker/QEMU tested
• ✅ Production ready

Requirements

• Raspberry Pi 4/5 or compatible
• Raspberry Pi OS (Lite or Desktop)
• 32GB+ MicroSD card
• Administrator access to router
• SSH client for initial access

Where to Start

New to Pi Gateway? → Start with Quick Start Guide

Ready to dive deep? → Read System Architecture

Need help? → Check Troubleshooting

Want to contribute? → See Development Guide

---

Navigation

Getting Started

Installation, setup, and first steps

Guides

SSH, VPN, firewall, and architecture

Operations

Daily management, monitoring, troubleshooting

Development

Contributing, testing, extending

Reference

Technical deep-dive, blog, FAQ

---

Latest Version: v1.4.0 License: MIT GitHub: 1mb-dev/pi-gateway