Galactropy

> SYSTEM_ROOT

MODULE SELF-HOSTED ENTROPY GENERATOR GUIDE

Theme
Language
TECHNICAL GUIDE OPEN SOURCE

> SELF_HOSTING

Run Your Own Physical Entropy Node

Galactropy is MIT-licensed and built to be self-hosted: clone the repo, plug in an SDR receiver, and run docker compose up. This page covers what you need and the three commands to get a node running. The full environment-variable reference and multi-host deployment profiles live in the README on GitHub.

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