# 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