p2pool/params.conf.example

# P2Pool Configuration File Example
# Copy this file to /var/lib/p2pool/params.conf and edit as needed
# Compatible with: p2pool v4.15+

# =============================================================================
# Monero Node Connection (REQUIRED)
# =============================================================================
# IP address or hostname of your Monero node
host = 127.0.0.1

# Monero RPC port
rpc-port = 18081

# Monero ZMQ port (required for optimal performance)
# v4.14+: ZMQ connections now support IPv6 addresses
zmq-port = 18083

# =============================================================================
# Wallet Configuration (REQUIRED)
# =============================================================================
# Your Monero wallet address - THIS IS REQUIRED
# Replace with your actual wallet address
wallet = YOUR_MONERO_WALLET_ADDRESS

# =============================================================================
# P2P Network Settings
# =============================================================================
# P2P bind address and port for P2Pool network communication
p2p = 0.0.0.0:37889

# Add known peer nodes (optional)
# addpeers = node1.p2pool.io:37889,node2.p2pool.io:37889

# HAProxy PROXY Protocol v2 for P2P connections (v4.14+)
# Enable ONLY if p2pool's P2P port is behind a proxy that sends PROXY Protocol
# v2 headers (e.g. HAProxy with "send-proxy-v2" directive).
# When enabled, the real client IP is extracted from the PROXY header and used
# for peer management, ban checks and logging — instead of the proxy's IP.
# P2P traffic is typically low-volume and usually does NOT need load balancing;
# leave commented out unless you have a specific reason to proxy P2P.
# Leave commented to disable; uncomment to enable.
# p2p-proxy-protocol = true

# =============================================================================
# API Settings
# =============================================================================
# Directory for data API files
data-api = /var/lib/p2pool/data-api

# Enable local API (recommended for monitoring)
local-api = true

# =============================================================================
# Mining Mode
# =============================================================================
# Use mini sidechain for smaller miners (lower difficulty)
# Uncomment if your hashrate is less than 50 KH/s
# mini = true

# =============================================================================
# Stratum Server (for connecting miners)
# =============================================================================
# Enable stratum server for miners to connect
# Format: <bind_ip>:<port>
# stratum = 0.0.0.0:3333

# HAProxy PROXY Protocol v2 for Stratum connections (v4.14+)
# Enable ONLY if p2pool's Stratum port is behind a proxy that sends PROXY
# Protocol v2 headers (e.g. HAProxy with "send-proxy-v2" directive).
# When enabled, miners' real IP addresses are correctly extracted and shown
# in the `workers` command output, and per-IP ban/rate-limiting works properly.
# This is an open standard also supported by nginx, Traefik, AWS ELB, etc.;
# it is NOT tied to HAProxy specifically.
#
# ⚠️  TLV extensions (send-proxy-v2-ssl, send-proxy-v2-ssl-cn,
#     unique-id-format, crc32c) are silently ignored — only the address block
#     is read. Do NOT use exact addr_len checks in custom builds (spec §2.2
#     allows senders to append TLV vectors, increasing addr_len beyond the
#     base 12 / 36 bytes).
#
# Leave commented to disable; uncomment to enable.
# stratum-proxy-protocol = true

# =============================================================================
# Merge Mining (Optional)
# =============================================================================
# Enable Tari merge mining
# Format: tari://<tari_node_ip>:<port> <tari_wallet_address>
# merge-mine = tari://127.0.0.1:18142 YOUR_TARI_WALLET_ADDRESS

# =============================================================================
# Logging
# =============================================================================
# Log file location
log-file = /var/log/p2pool/p2pool.log

# Log level (0 = none, 1 = fatal, 2 = error, 3 = warn, 4 = info, 5 = debug, 6 = trace)
loglevel = 3

# Disable logging destinations (v4.15+)
# Leave commented unless you want to disable logging output.
# disable-log is equivalent to no-console-log + no-log-file and saves ~8 MB RAM.
# no-console-log = true
# no-log-file = true
# disable-log = true

# =============================================================================
# Performance Tuning (Advanced)
# =============================================================================
# in-peers = 10
# out-peers = 10

# =============================================================================
# Network Settings (Advanced)
# =============================================================================
# SOCKS5 proxy for outgoing connections
# socks5 = 127.0.0.1:9050

# SOCKS5 proxy type (v4.14+, i2p value added in v4.15)
# Controls how p2pool treats the SOCKS5 proxy configured above.
# Accepted values:
#   auto  - auto-detect by port number (9050 = Tor, 4447 = I2P; default)
#   plain - treat as a standard SOCKS5 proxy (no Tor/I2P-specific behavior)
#   tor   - treat as a Tor SOCKS5 proxy (enables .onion peer handling)
#   i2p   - treat as an I2P SOCKS5 proxy (enables .b32.i2p peer handling)
# Only meaningful when `socks5` is set; ignored otherwise.
# socks5-proxy-type = auto

# I2P support (v4.15+)
# Requires an I2P SOCKS proxy, usually 127.0.0.1:4447 with i2pd.
# Recommended for I2P-only P2P to avoid clearnet/DNS/UPnP leaks:
# socks5 = 127.0.0.1:4447
# socks5-proxy-type = i2p
# no-dns = true
# no-upnp = true
# no-clearnet-p2p = true
#
# Broadcast your I2P hidden service .b32.i2p address to peers.
# This address is linked to shares mined by your wallet; use a dedicated
# I2P address for mining.
# i2p-address = YOUR_I2P_ADDRESS.b32.i2p