https://github.com/weebdatahoarder/p2pool-compose

docker-compose setup of Monero's p2pool
https://github.com/weebdatahoarder/p2pool-compose

docker docker-compose monero monero-mining p2pool

Last synced: about 1 year ago
JSON representation

docker-compose setup of Monero's p2pool

• Host: GitHub
• URL: https://github.com/weebdatahoarder/p2pool-compose
• Owner: WeebDataHoarder
• License: gpl-3.0
• Archived: true
• Created: 2021-09-07T18:43:57.000Z (almost 5 years ago)
• Default Branch: master
• Last Pushed: 2022-08-23T21:07:25.000Z (almost 4 years ago)
• Last Synced: 2025-03-15T17:14:44.566Z (over 1 year ago)
• Topics: docker, docker-compose, monero, monero-mining, p2pool
• Language: Dockerfile
• Homepage:
• Size: 47.9 KB
• Stars: 22
• Watchers: 3
• Forks: 7
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

          
# Monero p2pool docker-compose

This is an easy to setup installation of Monero's [p2pool](https://github.com/SChernykh/p2pool), a decentralized pool for Monero mining.

## Requirements

* docker / podman

* docker-compose

* Huge pages setup and mounted under _/dev/hugepages_ or similar

  * `$ sudo sysctl vm.nr_hugepages=3072`

  * You can add `vm.nr_hugepages=3072` to _/etc/sysctl.conf_ so it persists reboots.

  * Check that you have _/dev/hugepages_ (or other) as a `hugetlbfs` mount

* At least 48 GiB of free space for pruned Monero and p2pool chain data.

  * _monero_ runs in pruned mode, but that's still about 38-39 GiB at the time of writing.

  * _p2pool_ uses 500 MiB at this point in time, could use more.

* x86_64 or AArch64 system (probably works on others, untested)

* About 4 GiB of RAM. Haven't tested below this, but should help during sync. A bit more works better. 

## How to

* Clone / download this repository

  * `$ git clone https://github.com/WeebDataHoarder/p2pool-compose && cd p2pool-compose`

* Copy _.env.example_ to _.env_

  * `$ cp .env.example .env`

* Change _.env_ values to fit your needs. This is the main configuration.

  * You don't need to change everything, but at least, you SHOULD change `P2POOL_WALLET_ADDRESS`.

    * You should probably create a wallet for this. This address is exposed to p2pool peers (although later pruned)

  * You can override further by using `docker-compose.override.yml`.

* Build and start the services via _docker-compose_

  * `$ docker-compose up -d --build` (this will take a while to compile)

  * Monero syncing will also start. **This can take a few days.**

  * You can bring everything down via `$ docker-compose down`

  * View logs via `docker logs`

  * By default `master` branch of p2pool is used.

* To update (new version, or new p2pool version)

  * `git pull && docker-compose build --no-cache p2pool && docker-compose up -d --build`

## Notes and other comments

* _monerod_ has higher connection defaults and several presets to have quicker and larger reach when receiving and broadcasting new blocks.

* _monerod_ has a custom patch applied for the special RPC and ZMQ methods p2pool requires. After [PR#7891](https://github.com/monero-project/monero/pull/7891) is merged, this patch won't be necessary. 

* _p2pool_ stratum port is by default 3333. You can change this on _.env_, and can also point xmrig-proxy or similar to this port.

* _p2pool_ will wait until _monerod_ is running and fully synchronized before starting.

* You can attach to _p2pool_ console via `$ docker attach p2pool-compose_p2pool_1`. Detach via `Ctrl+p, Ctrl+q` 

* Everything restarts by default

* If you have other questions, feel free to reach _DataHoarder_ over IRC `#monero-pow @ irc.libera.chat`

## TODO

* logrotate for p2pool

  * However, you can set this up yourself directly pointing to file `/var/lib/docker/volumes/p2pool-compose_p2pool/_data/p2pool.log`

## Contribution

There is no dev fee. p2pool has no infrastructure. Send donations if you like, or don't.

[![Donate Monero](https://img.shields.io/badge/Donate-Monero-green.svg)](monero:4AeEwC2Uik2Zv4uooAUWjQb2ZvcLDBmLXN4rzSn3wjBoY8EKfNkSUqeg5PxcnWTwB1b2V39PDwU9gaNE5SnxSQPYQyoQtr7)

Donate hashrate to the [P2Pool Seed Node we run](https://p2pool-seed.northeurope.cloudapp.azure.com), at stratum server `p2pool-seed.northeurope.cloudapp.azure.com:3333`

Think about donating to [p2pool's original author](https://github.com/SChernykh/p2pool#donations) as well.