[Support] gupax-docker — Monero mining via P2Pool + XMRig, browser GUI, optional Tor

gupax-docker — Monero mining, containerized

Docker packaging for Gupax — the GUI that unites P2Pool and XMRig for easy, decentralized Monero mining. Self-contained with noVNC — open the web GUI in your browser, no X11 server needed.

✨ Features

• 🌐 Browser GUI — noVNC web interface on port 6080, just open http://your-unraid-ip:6080

• 🖥️ Gupax GUI — manage P2Pool, XMRig, and monerod all from one graphical interface

• 🔗 Decentralized mining — P2Pool pools your hashrate trustlessly, with no pool operator

• 💾 Persistent config — Gupax settings, mining binaries, blockchain, and Tor keys survive container restarts

• 🐋 Unraid-ready template — submitted to Community Applications, with full port/volume/env mappings

• 🧅 Optional Tor hidden service — run your node as a .onion for private transaction relay

🧅 Tor Integration

When TOR_ENABLED=true is set, the container starts a Tor daemon with:

• SOCKS5 proxy on 127.0.0.1:9050 for --tx-proxy

• Hidden service exposing your node's Wallet RPC (:18081) and P2P inbound (:18084) as a .onion address

The container uses tx-only mode — P2P blockchain sync stays on clearnet; only wallet-originated transactions (~2 KB) route through Tor. This keeps bandwidth through the volunteer Tor network negligible while still protecting transaction privacy.

The .onion address persists across restarts via the gupax-tor volume (your hidden service private key stays intact).

🚀 Installation

Via Community Applications (once approved):

1. Go to Apps → search "gupax"

2. Click Install

3. Set SCREEN_RESOLUTION if needed (default: 1920x1080x24)

4. Optionally set TOR_ENABLED=true and `VNC_AUTH_TOKEN=***

5. Click Apply

Manual install (if not yet in CA):

wget -O /boot/config/plugins/dockerMan/templates-user/gupax-docker.xml \
  https://raw.githubusercontent.com/libre-7/gupax-docker/main/templates/gupax-docker.xmlCopy

Then Docker → Add Container and select the "gupax" template.

🔧 Template Settings

📌 Ports

📍 Volumes

⚠️ Important Notes for New Users

1. Wallet address is set inside the Gupax GUI (Node tab), not as a Docker env var. If you don't see a Node tab, go to Settings → Tabs and enable it.

2. Tor setup requires pasting --tx-proxy + --anonymous-inbound args from the container startup log into Gupax's Node → Arguments field. Complete step-by-step in the README.

3. P2Pool ZMQ fix — Gupax has a known bug where it copies the wrong port (18081) into P2Pool's --zmq-port. Change it to 18083 in P2Pool → Advanced → Arguments.

🔗 Links

• Project / source: github.com/libre-7/gupax-docker

• Documentation: README.md

• Container images: ghcr.io/libre-7/gupax-docker / libre7/gupax-docker (Docker Hub)

• Docker Hub pulls: hub.docker.com/r/libre7/gupax-docker

• License: GPL v3

🙋 Support

Post in this thread for help, or open an issue on GitHub.

Disclaimer: Mining cryptocurrency consumes significant electricity and may not be profitable depending on your hardware and electricity costs. This is provided as-is for educational and convenience purposes. Do your own research.