Pi-Network-Node
Pi-Network-Node
Docker app from BitCryptic's Repository
Overview
Pi Network Node (Docker) template for Unraid — maintained by BitCryptic. This image wraps the official Pi Network node image with performance tuning applied out of the box, significantly reducing CPU and host load compared to running the upstream image directly. Upstream image: pinetwork/pi-node-docker:organization-mainnet-v1.0-p23.0.1 Source / changelog: https://github.com/bitcryptic-gw/Unraid-pi-network-node Performance optimisations included: - INGEST_DISABLE_STATE_VERIFICATION=true — disables periodic full ledger state scans (main CPU reduction) - PARALLEL_JOB_SIZE=1 — reduces horizon ingestion worker parallelism - HISTORY_RETENTION_COUNT=125000 — retains ~1 weeks of ledger history instead of all history since genesis Persistent data: - Map a host path to /opt/stellar (required). Ports (Pi standard): - 31401 -> 8000 (Horizon HTTP) - 31402 -> 31402 (stellar-core peer) - 31403 -> 1570 (Local history server / webfsd) Notes: - POSTGRES_PASSWORD is required. - NODE_PRIVATE_KEY is optional (advanced): leave blank for new nodes; set only if migrating an existing node identity. - --mainnet and --enable-auto-migrations are passed as Post Arguments.
Runtime arguments
- Web UI
http://[IP]:[PORT:8000]/- Network
bridge- Shell
sh- Privileged
- false
Template configuration
/opt/stellarPathrw
Persistent node data (required).
- Default
- /mnt/cache/appdata/pi-node-mainnet/stellar
/var/log/supervisor (optional)Pathrw
Optional: persist supervisor logs.
- Target
- /var/log/supervisor
- Default
- /mnt/cache/appdata/pi-node-mainnet/supervisor_logs
POSTGRES_PASSWORDVariable
Required. Database password for the node (keep secret).
NODE_PRIVATE_KEY (optional)Variable
Optional (advanced). Existing node private key for migrations. Leave blank for new nodes; key will be auto-generated.
- Target
- NODE_PRIVATE_KEY
Horizon HTTP (host 31401)Porttcp
Horizon HTTP (Pi standard). Forward this on your router if required by Pi port checks.
- Target
- 8000
- Default
- 31401
Stellar peer (host 31402)Porttcp
stellar-core peer port (Pi standard). Forward this on your router if required by Pi port checks.
- Target
- 31402
- Default
- 31402
Local history server (host 31403)Porttcp
Local history server / webfsd (Pi standard). Forward this on your router if required by Pi port checks.
- Target
- 1570
- Default
- 31403
Categories
Download Statistics
638
Total Downloads
Details
Repository
bitcryptic/pi-network-node:latestLast Updated2026-05-27
First Seen2026-05-13
Run Pi-Network-Node on Unraid.
Pi-Network-Node is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.