wrolpi/pi-gen
Roland fbb71e012d Replace nginx with Caddy for TLS termination and reverse proxying.
- Replace nginx with Caddy as the web server for both Docker and native
  (RPi/Debian) deployments. Caddy handles HTTPS termination, reverse
  proxying to all services (API, React app, Controller, Kiwix, Help, Map),
  and serves the media/download file browsers.
- Generate a Root CA and signed leaf certificates for HTTPS. The Root CA
  uses Name Constraints to restrict signing to local addresses only
  (.local, localhost, and RFC 1918 private IP ranges), mitigating MITM
  risk if the CA key is compromised.
- Add an HTTP landing page that guides users through one-time CA
  certificate installation on iOS, Android, macOS, Windows, Linux, and
  Firefox, with auto-redirect when the cert is already trusted.
- Add trailing-slash redirects for /controller, /docs, /media, and
  /download so bare paths don't fall through to the React catch-all.
- Add a Root CA download link on the Settings page under Configs.
- Update help.sh diagnostics for IPv6 listener detection and HTTP/2
  status codes.
- Remove all nginx config files and the https_proxy Docker container.
- Bump wrolpi-help submodule with certificate documentation.
2026-03-07 18:48:44 -07:00
..
stage2/04-wrolpi Replace nginx with Caddy for TLS termination and reverse proxying. 2026-03-07 18:48:44 -07:00
build.sh Fetching latest release version when building images so they are named correctly. 2026-02-26 17:45:39 -07:00
config.txt Updating pi-gen build to use bookworm-arm64 branch. 2026-02-11 17:38:04 -07:00
README.md Building pi and debian images using branch by default, allowing specifying branch with -b option. 2026-02-22 15:09:15 -07:00

Pi-Gen

This directory exists to facilitate the creation of WROLPI Raspberry Pi OS images.

See https://github.com/RPI-Distro/pi-gen

Generate 64bit Raspberry Pi WROLPi image

  1. Convert a map PBF file to your initial map DB dump:

    docker run --rm -v /home/user/district-of-columbia-230111.osm.pbf:/data/region.osm.pbf lrnselfreliance/osm-map-dumper > pi-gen/stage2/04-wrolpi/files/map-db-gis.dump
    

    The output is already compressed (PostgreSQL custom format with --compress 9).

    Verify the dump format is correct:

    file pi-gen/stage2/04-wrolpi/files/map-db-gis.dump
    # Should show: "PostgreSQL custom database dump"
    
  2. Run the build (or, with a specific git branch)

    • Build release branch (default)

      sudo ./build.sh
      
    • Build specific branch

      sudo ./build.sh -b master
      
  3. The images are now in the pi-gen directory.