1. What you need
Hardware: an SDR receiver, either an RTL-SDR USB dongle (the cheapest option, around $25) or an Analog Devices PlutoSDR, plus any antenna that picks up ambient RF. Software: Docker, Docker Compose, and git. No GPU, no special OS beyond what Docker itself supports.
2. Three commands
Clone the repository, then build and start the stack:
git clone https://github.com/sparksomeventure/big-bang-entropy.git
cd big-bang-entropy
docker compose up --build
Once it's running, confirm the pool is alive:
curl http://localhost:8080/healthz
3. What you're actually running
Three containers, each with one job: sdr-node reads raw I/Q samples off the receiver and streams conditioned entropy over UDP; generator mixes incoming streams with SHA-512 into a 512 MB pool and exposes it over HTTP and raw TCP; nginx serves the web UI and proxies only the data endpoints. The architecture supports multiple SDR nodes running in parallel, and the whole thing can run behind a WireGuard tunnel without any application-level changes.
4. Full configuration reference
Environment variables for every host role (generator, SDR node, a dev setup with a dummy SDR source, WebRTC camera streaming), along with Docker Compose profiles and CLI diagnostics, are documented in the repository README.
> Full README on GitHub