# Public Pool

Public Pool is an open-source solo Bitcoin mining pool built on a NestJS/TypeScript stratum server, paired with a web UI for tracking your miners. It is open source and self-hosted, installable on Docker Hub, Unraid and Umbrel.

Canonical page: https://ourlocalhost.com/app/2445/public-pool

## Description

Public Pool is an open-source solo Bitcoin mining pool built on a NestJS/TypeScript stratum server, paired with a web UI for tracking your miners. It lets homelabbers self-host their own pool with support for custom IPs, custom ports, and direct Bitcoin node integration.

## Platform availability

Available on 2 of 10 platforms: Unraid, Umbrel.

## Health score

57/100 (Fair), based on 4 of 5 factors.
- Maintained: 58 (last commit 169 days ago)
- Popular: 53 (452 GitHub stars)
- Easy to install: 45 (2 install platforms, install notes, Docker image)
- Security check: 70 (no serious findings, 20 minor, CI, tests)

## Links

- Docker Hub: https://hub.docker.com/r/animai/public-pool
- Unraid: https://ca.unraid.net/apps/public-pool-0cex1uf1ovlzvv?q=public-pool
- Umbrel: https://apps.umbrel.com/app/public-pool
- GitHub: https://github.com/benjamin-wilson/public-pool

## Common questions

### Why can't miners reach the pool when running Docker Compose?

The compose file maps the Stratum ports to 127.0.0.1 by default. Change the 3333 and 3334 entries to expose those ports on your server before miners connect.

### What bitcoin.conf setting is required for the pool to use the Bitcoin RPC?

Add rpcallowip=172.16.0.0/12 to bitcoin.conf to successfully connect to the Bitcoin RPC.

### What PM2 and Node.js settings are needed for cluster mode?

Use Node.js 22.12.0 or newer, and start the PM2 daemon with NODE_CLUSTER_SCHED_POLICY=none. The environment variable must be present when the daemon starts, not only in the worker configuration.

### How is STRATUM_MAX_CONNECTIONS_PER_LISTENER calculated?

It is enforced per worker and Stratum port. Size it using the busiest port by multiplying worker count by the limit, for example 28 workers with the default 10000 limit allow up to 280000 connections on one port.

---
Source: Our Local Host (https://ourlocalhost.com/app/2445/public-pool), the self-hosted and open-source app directory.
