xmrig/xmrig-proxy repository overview

⁠XMRig Proxy in Docker (Alpine Linux)

Lightweight, high-performance Stratum proxy for XMRig miners, based on Alpine Linux.

⁠Why Use XMRig-Proxy?

XMRig-Proxy sits between your mining rigs and the mining pool:

• Reduces Pool Connections: Combines hundreds or thousands of miner connections into 1–5 pool connections.
• Minimizes Network Overhead: Reduces outbound bandwidth and latency.
• Consolidated Statistics: Monitor workers, hashrates, and shares in one place via HTTP REST API.
• Custom Difficulty: Distribute dynamic difficulty to workers without burdening the pool.

⁠Features

• XMRig-Proxy v6.26.0: Built from source on Alpine Linux 3.21.
• TLS / SSL Support: Native encrypted uplink to upstream pools and downlink to miners.
• REST API Support: Built-in HTTP server for metrics and health checks.
• Ultra-lightweight: Multi-stage build stripped down to ~25 MB (<8 MB compressed).
• Security: Runs under an unprivileged proxy user.

⁠Quick Start

⁠1. Basic CLI Setup

Run the proxy binding to port 3333 and forwarding to your favorite pool:

docker run -d --name xmrig-proxy \
  -p 3333:3333 \
  xmrig/xmrig-proxy:latest \
  -b 0.0.0.0:3333 \
  -o pool.supportxmr.com:3333 \
  -u YOUR_WALLET_ADDRESS \
  -p x

Then point your local miners to this proxy host:

xmrig -o IP_OF_PROXY_HOST:3333 -u RIG_WORKER_NAME -p x

⁠2. With Upstream TLS

docker run -d --name xmrig-proxy \
  -p 3333:3333 \
  xmrig/xmrig-proxy:latest \
  -b 0.0.0.0:3333 \
  -o pool.supportxmr.com:9000 \
  -u YOUR_WALLET_ADDRESS \
  -p x \
  --tls

⁠3. Using a Custom config.json

Mount your proxy configuration directly into the container:

docker run -d --name xmrig-proxy \
  -p 3333:3333 \
  -v $(pwd)/config.json:/xmrig-proxy/config.json:ro \
  xmrig/xmrig-proxy:latest \
  -c /xmrig-proxy/config.json

⁠Docker Compose Example

version: '3.8'

services:
  xmrig-proxy:
    image: xmrig/xmrig-proxy:latest
    container_name: xmrig-proxy
    restart: unless-stopped
    ports:
      - "3333:3333"
    command:
      - -b
      - 0.0.0.0:3333
      - -o
      - pool.supportxmr.com:3333
      - -u
      - YOUR_WALLET_ADDRESS
      - -p
      - docker-proxy

⁠Available Tags

• 6.26.0, 6.26, 6, latest — XMRig-Proxy v6.26.0 (Alpine 3.21)

⁠Upstream & Documentation

• Official GitHub Repository: github.com/xmrig/xmrig-proxy⁠
• Official Documentation & Configuration: xmrig.com/docs/proxy⁠