# Pi Network Node

Pi Network Node is an Unraid Docker template that runs the official Pi Network node on mainnet with performance tuning baked in, significantly reducing CPU and host load. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/2403/pi-network-node

## Description

Pi Network Node is an Unraid Docker template that runs the official Pi Network node on mainnet with performance tuning baked in, significantly reducing CPU and host load. Maintained by BitCryptic, it wraps the upstream pinetwork/pi-node-docker image for homelab users who want a low-maintenance, optimised Pi Network node.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

45/100 (Fair), based on 4 of 4 factors.
- Maintained: 84 (last commit 10 days ago)
- Popular: 0 (0 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 30 (4 GB minimum RAM)

## Links

- Docker Hub: https://hub.docker.com/r/bitcryptic/pi-network-node
- Unraid: https://ca.unraid.net/apps/pi-network-node-0gsox5a1cnsa9m?q=Pi-Network-Node

## Common questions

### What must I map and set before starting the Pi node container?

Map a host path to /opt/stellar so the node can persist its data, and set POSTGRES_PASSWORD because the node's Postgres instance requires it.

### Which ports does the Unraid template expose?

The template maps 31401 to Horizon HTTP and 31402 to stellar-core peer traffic. It also documents 31403 for the local history server, but only 31401 and 31402 are mapped by the template.

### How does the template reduce CPU and host load?

It disables periodic full ledger state verification, limits Horizon ingestion to one worker, and retains about eight weeks of history instead of the full history. These settings are applied through environment variables in the wrapper image.

### How do I reuse an existing Pi node identity?

Set NODE_PRIVATE_KEY only when migrating an existing node, and leave it blank for a new node so the container generates one. Do not run two nodes with the same private key at the same time.

### What should I check if the node remains stuck at 1?

A node stuck at 1 may still be downloading the ledger in the background, or it may be having trouble finding sources.

---
Source: Our Local Host (https://ourlocalhost.com/app/2403/pi-network-node), the self-hosted and open-source app directory.
