← sources

Pi-Dock-Wifi: a Raspberry Pi 5 router with two Wi-Fi cards, Pi-hole and web dashboard

source: reddit (reddit:selfhosted)published 2026-11-11 20:30ingested 2026-11-12 02:39

retained text

Hi everyone!

I’ve been using a Raspberry Pi 5 as my Wi-Fi router for my entire apartment, and I’ve now published the project as open source.

The goal was to have direct control over the whole setup: wireless configuration, DHCP, DNS, routing, firewall rules and the scripts that keep everything running.

The hardware is probably pretty unusual ...

\- Raspberry Pi 5 with 8 GB RAM.

\- A 52Pi B14 PCIe switch HAT and two Waveshare MiniPCIe adapters.

\- Two MediaTek MT7915E Wi-Fi cards.

\- USB NVMe storage because pcie 32bit dma to make wifi cards work,

\- An USB hub HAT

\- 52Pi P01 power board

\- Custom 3D-printed mounting plates and antenna supports.

The PCIe cards share the Pi’s single PCIe uplink through the switch.

All is managed through Docker Compose with three interconnected services:

* **Pi-Dock-Wifi:** hostapd, separate 2.4 GHz and 5 GHz access points, dnsmasq, routing, firewall rules and a web dashboard.
* **Pi-hole:** DNS filtering using the official image.
* **ttyd:** an SSH terminal accessible through the dashboard.

There are also health checks, Ethernet recovery handling, logs and network statistics.  
Pi-dock-wifi is designed to repair itself as much as possible.  
The interface and project logs support English and Italian, selected through a Compose variable.

I’ve included the Dockerfiles, scripts, configuration examples, hardware documentation,  
STL/OpenSCAD files, boot settings and the complete kernel configuration used by my router. There’s also a guide covering kernel compilation, installation, verification and recovery.

**T**his project uses host networking and a privileged router container.  
The host needs compatible kernel drivers and AP-capable radios.

The running router is my reference system; a fresh installation following the complete public guide still needs independent validation.

**Repository:** [citroale90/pi-dock-wifi](https://github.com/citroale90/pi-dock-wifi)  
**English README:** [Overview and documentation](https://github.com/citroale90/pi-dock-wifi/blob/main/README.en.md)

The project is GPL-3.0.  
Feedback on the network configuration, documentation and reproducibility would be particularly useful!

I started with this project in 2020 during the pandemic and it has evolved to where I am now.

document fetched 2026-11-12 00:30 · canonical https://reddit.com/r/selfhosted/comments/1xtsr4b/pidockwifi_a_raspberry_pi_5_router_with_two_wifi