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

Download Statistics

638
Total Downloads

Details

Repository
bitcryptic/pi-network-node:latest
Last 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.