koopa-admin-log/configs/nym/README.md
2026-07-16 15:04:00 +02:00

2 KiB

Nym node — koopa (koopa-nym)

Podman container koopa-nym runs a nym-node from nym.com (Nym mixnet / NymVPN network).
Host layout (live): ~/koopa-nym/.
Mirror in this repo: configs/nym/.

Setting Value
Container koopa-nym
Image localhost/koopa-nym:latest
Default mode mixnode (safest on a home host; no open-internet exit)
Optional modes entry-gateway, exit-gateway (+ WireGuard for dVPN) — see env
Local ID koopa-nym
Data ~/.nym/nym-nodes/koopa-nym/ inside volume ./data
Operator T&Cs must pass --accept-operator-terms-and-conditions every run

Ports (host) — avoid Caddy 9000/9001 and Tor 8080

Role nym-node default Host publish
HTTP API / swagger 8080 9080
Mixnet Sphinx 1789 1789
Verloc 1790 1790
Entry client WS 9000 19000 (only if gateway mode)
WireGuard 51822 51822 (only if WG enabled)

VeciGate / firewall: open only what the chosen mode needs.
Exit-gateway and WireGuard expose the host IP to abuse complaints — read Nym exit counsel before enabling.

Files

File Role
Containerfile Debian slim + nym-node binary
entrypoint.sh env → nym-node run …
compose.yml podman/docker compose
.env.example non-secret knobs
container-koopa-nym.service systemd --user unit template

Ops (sketch)

cd ~/koopa-nym   # or this mirror
cp .env.example .env   # edit PUBLIC_IPS, LOCATION, MODE
podman build -t localhost/koopa-nym:latest -f Containerfile .
podman compose up -d   # or podman run …
# bonding: use Nym wallet / harbourmaster; node must accept operator T&Cs
curl -sS http://127.0.0.1:9080/api/v1/roles | jq .

Secrets / wallet mnemonics never live in this repo — see root SECRETS.md.