Bill of Materials

Pi 5 needs 5 V/5 A headroom (official PSU shown in docs). PoE+ HAT powers Pi 4 via 802.3at. Power table • PoE+ HAT

Wiring & Network Layout

12/24V DC → Fuse → 5V Buck → Pi (or PoE+ Injector → Pi PoE+ HAT)
Pi (eth0) → Router LAN (OpenWrt + openNDS captive portal)
Clients → Wi-Fi SSID (portal) → redirect to http://srv/ (Homepage)
Ports: /maps (8080), /wiki (8090), /bulletin (9001) proxied behind :80

openNDS = maintained captive portal for OpenWrt; configure splash + redirect URL. OpenWrt wiki

Step-by-Step (Do these in order)

1. Flash OS: Raspberry Pi OS (64-bit Lite); enable SSH; hostname srv. Optional: enable USB/NVMe boot. Pi docs
2. Install Docker Engine (Debian/ARM64): follow official instructions (Docker apt repo). Docker on Debian
3. Create folders: /srv/maps /srv/kiwix /srv/board /srv/proxy
4. Offline content: Place my-region.mbtiles into /srv/maps. Put ZIM files into /srv/kiwix/zim. OpenMapTiles • Kiwix-serve
5. Compose services: Use the docker-compose file below; bring up with docker compose up -d. TileServer-GL config (MBTiles) included. TileServer-GL docs
6. SMB share: Install Samba on host; add a public share to /srv/share. Samba guide
7. Router portal: On OpenWrt, install openNDS; set splash and redirect URL to http://srv/. openNDS docs
8. Attribution: Show “© OpenStreetMap contributors” near the map and link ODbL. OSMF attribution

Docker Compose (paste into /srv/docker-compose.yml)

services:
  tiles:
    image: maptiler/tileserver-gl
    command: ["--port","8080","--config","/data/config.json"]
    volumes: [ "./maps:/data" ]
    ports: ["8080:8080"]
    restart: unless-stopped

  kiwix:
    image: ghcr.io/kiwix/kiwix-serve:3.7.0
    command: ["/usr/bin/kiwix-serve","--port=8090","--library","/data/library.xml","/data"]
    volumes: [ "./kiwix:/data" ]
    ports: ["8090:8090"]
    restart: unless-stopped

  etherpad:
    image: etherpad/etherpad:latest
    environment:
      - TITLE=GamerzCrave Bulletin
      - DEFAULT_PAD_TEXT=Welcome to the offline bulletin.
    volumes: [ "./board:/opt/etherpad-lite/var" ]
    ports: ["9001:9001"]
    restart: unless-stopped

  nginx:
    image: nginx:alpine
    volumes:
      - ./proxy/nginx.conf:/etc/nginx/nginx.conf:ro
      - ./proxy/www:/usr/share/nginx/html:ro
    ports: ["80:80"]
    depends_on: [ tiles, kiwix, etherpad ]
    restart: unless-stopped

TileServer-GL Config (/srv/maps/config.json)

{
  "options": { "paths": { "root": "/data", "mbtiles": "/data" } },
  "styles": { "bright": { "style": "bright.json" } },
  "data": { "planet": { "mbtiles": "my-region.mbtiles" } }
}

TileServer-GL can point directly at local MBTiles. Config docs

Nginx Reverse Proxy & Homepage

# /srv/proxy/nginx.conf
events {}
http {
  server {
    listen 80;
    location = / { root /usr/share/nginx/html; try_files /index.html =404; }
    location /maps/     { proxy_pass http://tiles:8080/; }
    location /wiki/     { proxy_pass http://kiwix:8090/; }
    location /bulletin/ { proxy_pass http://etherpad:9001/; }
    add_header Cache-Control "no-store";
  }
}

Offline Server-in-a-Box

  
Maps (OSM © contributors)
  
Wiki & Manuals
  
Bulletin Board
  
File Share

Samba Share (host)

# Create and expose a guest-friendly share
sudo apt -y install samba
sudo mkdir -p /srv/share
sudo chown -R nobody:nogroup /srv/share
printf "\n[public]\npath=/srv/share\nbrowseable=yes\nread only=no\nguest ok=yes\nforce user=nobody\n" | sudo tee -a /etc/samba/smb.conf
sudo systemctl restart smbd

Full parameter reference in Samba’s smb.conf docs.

Quick-Start (printable)

Maintenance & Safety

• Keep vents clear; verify buck holds 5.1 V under load.
• Show OSM attribution near maps + link the copyright page.
• Portal splash: terms + privacy note; don’t MITM traffic.

Sources

• Kiwix-serve (ZIM over HTTP): docs.
• OpenMapTiles + TileServer-GL (Docker + MBTiles): OpenMapTiles • TileServer-GL • MBTiles config.
• openNDS captive portal on OpenWrt: OpenWrt wiki • docs.
• Samba standalone server & smb.conf: guide • manpage.
• Docker Engine on Debian (ARM64 ok): docs.
• Pi power & PoE+: power table • PoE+ HAT.
• OSM license & attribution: copyright • attribution guidelines.