Gupax
Gupax is a browser-based graphical user interface (GUI) that unifies P2Pool and XMRig for decentralized Monero mining.
Platform availability
Available on 1 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
50/100 Fair
- Maintained
- 82last commit 47 days ago
- Popular
- 123 GitHub stars
- Easy to install
- 351 install platform, install notes, Docker image
- Light to run
- No data
Based on 3 of 4 factors.
Availability: platform listings confirmed today, links checked 22 days ago
- GitHub stars
- 3
- Open issues
- 12
- Last commit
- 2026-10-05
- Latest release
- v2.0.1-20261005
- License
- GPL-3.0
- Activity
- stale
Checked 7 days ago - source: GitHub (libre-7/gupax-docker)
Resources & Compatibility
Requirements not published yet.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Check your Monero node if P2Pool warns it is behind If P2Pool says a peer is ahead on the mainchain (the official Monero blockchain), your monerod (Monero full node) may be stuck or slow. Make sure it is fully synced, otherwise P2Pool may not submit valid shares. source
- Open Monero RPC and ZMQ ports for remote nodes If you see a P2Pool RPC request failure, check that your monerod's RPC (remote command) and ZMQ (fast update) ports, often 18089 and 18084, are open and reachable. Without them P2Pool cannot ask the node for data and will retry or use a backup node. source
Fetched 47 days ago - each note links to its source
Variants
Alternatives
No alternatives collected yet.
Common questions
How do I access the Gupax Docker GUI from a browser?
Open the noVNC web interface on port 6080 and click Connect. No password is required by default.
Where should I store Gupax data so settings and the Monero node survive container restarts?
Mount persistent volumes for /home/miner/.local/share/gupax and /home/miner/.bitmonero. The Docker example uses gupax-data and gupax-monero for these paths.
How do I enable the optional Tor hidden service in the Gupax Docker image?
Set TOR_ENABLED=true. This starts a Tor daemon with a SOCKS5 proxy on 127.0.0.1:9050 and exposes the Monero node as a .onion hidden service.
What should I check if P2Pool reports RPC failures or says the node is behind?
Make sure monerod is fully synced, because a stuck or slow node can prevent valid shares. Also confirm the monerod RPC and ZMQ ports, often 18089 and 18084, are open and reachable.
Answers sourced from github.com, github.com
Community
- Gupax is my new favorite : r/MoneroMining - Reddit (reddit)
- [CCS Proposal] Gupax: GUI for P2Pool+XMRig - Reddit (reddit)
- Gupax v1.0.0 released - GUI for P2Pool+XMRig : r/Monero - Reddit (reddit)
- Anyone using Gupax on Ubuntu 20.04 or in my case Lubuntu? - Reddit (reddit)
- Gupax v1.2.0 released : r/MoneroMining - Reddit (reddit)
- how do i mine in p2pool without using GUPAX : r/MoneroMining - Reddit (reddit)
Collected 49 days ago - public community threads