Skip to content

DOCKER-GUIDE.md

Latest commit

 

History

History
273 lines (202 loc) · 6.91 KB

DOCKER-GUIDE.md

File metadata and controls

273 lines (202 loc) · 6.91 KB
Raw

Monero Pool - Docker Deployment Guide

🚀 Quick Start

Prerequisites

  1. Docker Desktop for Windows - Download here
  2. At least 100 GB of free disk space (for pruned blockchain)
  3. A Monero wallet address for receiving mining rewards

Installation

  1. Run the setup script (as Administrator):

    setup-windows.bat

  2. Edit your configuration:

    notepad C:\MoneroPool\config\pool.conf

    IMPORTANT: Change pool-wallet to your Monero wallet address!

  3. Start the pool:

    docker-compose up -d

  4. Wait for blockchain sync (can take several hours on first run):

    docker-compose logs -f monerod

📁 Directory Structure

C:\MoneroPool\
├── blockchain\     ← Monero blockchain data (~70 GB pruned)
├── wallet\         ← Wallet RPC data
├── pool-data\      ← Pool database (shares, payments) - CRITICAL!
├── config\         ← Configuration files
│   └── pool.conf   ← Main pool configuration
└── backups\        ← Automated backups

🔧 Common Commands

Action Command
Start pool docker-compose up -d
Stop pool docker-compose down
View logs docker-compose logs -f
View pool logs only docker-compose logs -f monero-pool
Restart pool docker-compose restart monero-pool
Rebuild after update docker-compose build --no-cache && docker-compose up -d
Check status docker-compose ps

🌐 Access Points

Service URL/Address
Web UI http://localhost:80 ou http://euroxmr.eu
Stratum (miners) stratum+tcp://euroxmr.eu:4242
Stratum SSL stratum+ssl://euroxmr.eu:4343
Monerod RPC http://localhost:18081
Wallet RPC http://localhost:28084

🔐 SSL/TLS Configuration (HAProxy)

Le pool supporte les connexions SSL via HAProxy. Pour activer :

1. Créer le certificat

# Option A: Let's Encrypt
certbot certonly --standalone -d euroxmr.eu
cat /etc/letsencrypt/live/euroxmr.eu/fullchain.pem \
    /etc/letsencrypt/live/euroxmr.eu/privkey.pem > euroxmr.pem

# Option B: Auto-signé (test)
openssl req -x509 -nodes -days 365 -newkey rsa:2048 \
  -keyout euroxmr.key -out euroxmr.crt -subj "/CN=euroxmr.eu"
cat euroxmr.crt euroxmr.key > euroxmr.pem

2. Placer les fichiers

mkdir C:\MoneroPool\config\certs
copy euroxmr.pem C:\MoneroPool\config\certs\
copy haproxy.cfg C:\MoneroPool\config\

3. Démarrer avec SSL

docker-compose --profile ssl up -d

4. Vérifier

docker logs haproxy-ssl

💾 Backup

Manual Backup

Run backup.bat to create a timestamped backup of:

  • Pool database (shares, balances, payments)
  • Wallet data
  • Configuration

Automated Backup

Schedule backup.bat with Windows Task Scheduler:

  1. Open Task Scheduler
  2. Create Basic Task → "Monero Pool Backup"
  3. Trigger: Daily at 3:00 AM
  4. Action: Start C:\Users\jessy\monero-pool\backup.bat

Restore from Backup

docker-compose down
powershell -Command "Expand-Archive -Path 'C:\MoneroPool\backups\backup_XXXX.zip' -DestinationPath 'C:\MoneroPool\' -Force"
docker-compose up -d

🎰 Loterie Hebdomadaire

Le pool inclut un système de loterie hebdomadaire pour gamifier l'expérience de minage.

Activer la Loterie

# 1. Créer les dossiers
mkdir C:\MoneroPool\lottery-output
mkdir C:\MoneroPool\lottery-data

# 2. Build et démarrer le service cron
docker-compose --profile lottery build lottery-cron
docker-compose --profile lottery up -d lottery-cron

Commandes Utiles

Action Commande
Voir les logs docker-compose logs -f lottery-cron
Stats actuelles docker-compose exec lottery-cron python /app/lottery_bot.py /app/data --stats
Tirage test docker-compose exec lottery-cron python /app/lottery_bot.py /app/data --run --dry-run
Générer JSON docker-compose exec lottery-cron python /app/lottery_api.py /app/data /app/output

Tâches Automatiques

Fréquence Tâche
Toutes les heures Génère lottery_stats.json
Dimanche 20h CET Exécute le tirage

Fichiers

  • C:\MoneroPool\lottery-output\lottery_stats.json - Stats pour le frontend
  • C:\MoneroPool\lottery-data\lottery_results.json - Historique des tirages

🔄 Auto-Start with Windows

Docker Desktop automatically starts with Windows by default. The pool has restart: always configured, so it will restart automatically.

To verify:

  1. Docker Desktop Settings → General → ✅ "Start Docker Desktop when you log in"
  2. The restart: always policy ensures containers restart after:
    • Windows reboot
    • Docker restart
    • Container crash

📊 Monitoring

Health Check

The pool container has a built-in health check. Check status:

docker inspect monero-pool --format='{{.State.Health.Status}}'

Resource Usage

docker stats

🔒 Security Recommendations

  1. Firewall: Only open port 4242 (stratum) to the internet
  2. Wallet Password: Use a strong password for your wallet
  3. Backups: Keep encrypted backups offsite
  4. Updates: Regularly rebuild the pool image for security patches

🆘 Troubleshooting

Pool won't start

docker-compose logs monero-pool

Blockchain sync issues

docker-compose logs monerod
# If corrupted, delete and resync:
docker-compose down
rmdir /S /Q C:\MoneroPool\blockchain
docker-compose up -d

Wallet issues

docker-compose logs monero-wallet-rpc

Reset everything

docker-compose down -v
rmdir /S /Q C:\MoneroPool
# Then run setup-windows.bat again

📝 Files Created

File Description
Dockerfile Multi-stage build for the pool
docker-compose.yml Orchestration configuration (inclut HAProxy + Lottery)
pool.docker.conf Docker-optimized pool config template
pool.conf Configuration pool avec port SSL 4343
haproxy.cfg Configuration HAProxy pour SSL/TLS termination
setup-windows.bat Initial setup script
backup.bat Backup automation script
og-image.png Image pour partage réseaux sociaux
EUROXMR-GUIDE.md Guide des personnalisations EuroXMR
src/webui-embed.html Interface web améliorée (5 langues, calculator, FAQ, Loterie)
tools/lottery_bot.py Script principal de tirage loterie
tools/lottery_api.py Générateur JSON pour le frontend loterie
tools/Dockerfile.lottery Docker image pour le service cron loterie
tools/lottery-crontab Configuration des tâches cron loterie

🔗 Useful Links