Initial commit

2026-06-30 18:30:24 +00:00
commit 67e0a90b15
54 changed files with 6184 additions and 0 deletions
@@ -0,0 +1,51 @@
+# The Dark Elite Hub - Portable Deployment
+
+Self-hosted SHTF knowledge hub with offline Wikipedia, maps, weather radar,
+PDF library, ham radio frequencies, supplies inventory, overlay route plotting,
+garden calendar, unified search, and password-gated remote access.
+
+## Quick start
+
+    sudo ./deploy.sh
+
+## Configuration
+
+Before deploying, copy .env.example to .env and edit:
+
+- HUB_PASSWORD - password for external login
+- HUB_SECRET - random key for cookies (run: openssl rand -hex 32)
+- CADDY_HTTP_PORT / CADDY_HTTPS_PORT - change if 80/443 are taken
+
+deploy.sh auto-generates HUB_SECRET if missing.
+
+## Module URLs (after deploy)
+
+- Dashboard: /
+- Library: /library/
+- Maps: /maps/
+- Weather: /weather/
+- PDFs: /pdfs/
+- Frequencies: /freqs/
+- Inventory: /inventory/
+- Search: /search/
+- Overlay: /overlay/
+- Garden: /garden/
+- Login: /login/
+- Logout: /logout
+
+## Not included
+
+- ZIM files (upload at /library/ after deploy)
+- PDF files (upload at /pdfs/ after deploy)
+- Map tiles (run fetch-maps.sh)
+
+## LAN bypass
+
+Requests from 10.0.0.0/24, 192.168.0.0/16, and 127.0.0.1 skip login.
+Edit skel/auth/data/app.py before tarball-ing if your LAN uses a different subnet.
+
+## Uninstall
+
+    cd /opt/hub-deploy
+    docker compose down -v
+    sudo rm -rf /opt/hub