wtf is 32-bit-wireguard-tor-vpn?

This project is a collection of shell scripts that turn a Raspberry Pi 4B into a personal privacy gateway. The idea is simple: devices like a laptop or phone connect to the Pi over WireGuard, an encrypted VPN protocol, and the Pi then routes all of that traffic through the Tor network before it reaches the internet. The result is that your internet provider only ever sees encrypted traffic going to the Pi, websites only see a random Tor exit node's address instead of yours, and anyone on the same WiFi network cannot see what you are doing at all. Setup is meant to be done entirely on the Pi itself, running 32 bit Raspberry Pi OS with sudo access. A single setup script installs WireGuard, Tor, and dnsmasq, and after that one command starts every service at once. Adding a new device, such as a phone or laptop, is handled by a script that generates a configuration file and a QR code, so most devices can connect just by scanning the code with the WireGuard app. The scripts also include ways to check that everything is actually working, both on the Pi and on the connecting device, by confirming that outgoing traffic really is passing through Tor. Beyond the basics, the README documents a long list of things that can go wrong on real Raspberry Pi hardware and how to fix them: connections timing out, DNS resolution failing, the interface being torn down because of a strict script setting, Tor not starting properly on some Pi OS images, and IP forwarding resetting after a reboot. Each of these comes with the exact commands needed to diagnose or resolve the problem. The project supports both IPv4 and IPv6 addressing with a defined internal network range and can handle up to 253 connected devices at once. It uses modern WireGuard encryption methods and is released under the MIT license, meaning it can be used, modified, and shared freely as long as the original copyright notice is kept.