Skip to content

Multi Container Scaling

Jump to bottom
github-actions[bot] edited this page Sep 18, 2026 · 2 revisions

🐳 Multi-Container Scaling

You can run multiple independent nodes in a single docker-compose.yml file. This is the most efficient way to scale on a single host because all nodes can share a single authentication session.

Use the 3-node example if you want to understand the pattern. Use the 5-node or 10-node templates if you want a larger stack ready to copy.

⚙️ How It Works

By sharing a single config volume, ur_config, you only need one auth code to authenticate the whole stack.

  1. Node 1 starts, detects the empty volume, and uses URNETWORK_AUTH_CODE to get a JWT.
  2. The other nodes wait through depends_on and Node 1's healthcheck until the shared JWT exists.
  3. Each node registers its own distinct client identity with the backend and reports to your dashboard with its own label.

The healthcheck avoids a cold-start race where dependent nodes would otherwise launch before the JWT is written and crash-loop until it appears.

📋 Choose a Template

Stack Size Best For
3 nodes Small deployments and learning the pattern.
5 nodes Moderate single-host scaling.
10 nodes Larger hosts where you want a ready fleet file.

Each service needs a unique service name, container name, host port, and vnStat volume. All nodes share ur_config for the JWT.

🚶 3-Node Walkthrough

services:
  # Node 1: Handles the initial authentication for the whole stack
  node-1:
    image: ghcr.io/full-bars/meso-miner:latest
    container_name: urfix-1
    restart: unless-stopped
    pull_policy: always
    cap_add: [NET_ADMIN, NET_RAW]
    sysctls:
      - net.ipv4.ip_forward=1
    environment:
      - BUILD=jwt
      - ENABLE_VNSTAT=true
      - HOST_HOSTNAME=${HOSTNAME}
      - URNETWORK_NODE_NAME=urfix-1
      - URNETWORK_AUTH_CODE=YOUR_AUTH_CODE # Only needed on Node 1
    volumes:
      - ur_config:/root/.urnetwork  # SHARED volume for JWT
      - urfix-1_vnstat:/var/lib/vnstat
      - ./proxy.txt:/app/proxy.txt
    ports:
      - "9001:8080"
    logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "3"

    # Reports healthy once the shared JWT is written, gating the other nodes' start
    healthcheck:
      test: ["CMD-SHELL", "[ -s /root/.urnetwork/jwt ]"]
      interval: 5s
      timeout: 3s
      retries: 30
      start_period: 10s

  # Node 2: Uses the JWT created by Node 1
  node-2:
    image: ghcr.io/full-bars/meso-miner:latest
    container_name: urfix-2
    restart: unless-stopped
    pull_policy: always
    cap_add: [NET_ADMIN, NET_RAW]
    sysctls:
      - net.ipv4.ip_forward=1
    depends_on:
      node-1:
        condition: service_healthy
    environment:
      - BUILD=jwt
      - ENABLE_VNSTAT=true
      - HOST_HOSTNAME=${HOSTNAME}
      - URNETWORK_NODE_NAME=urfix-2
    volumes:
      - ur_config:/root/.urnetwork  # SHARED volume
      - urfix-2_vnstat:/var/lib/vnstat
      - ./proxy.txt:/app/proxy.txt
    ports:
      - "9002:8080"
    logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "3"

  # Node 3: Uses the JWT created by Node 1
  node-3:
    image: ghcr.io/full-bars/meso-miner:latest
    container_name: urfix-3
    restart: unless-stopped
    pull_policy: always
    cap_add: [NET_ADMIN, NET_RAW]
    sysctls:
      - net.ipv4.ip_forward=1
    depends_on:
      node-1:
        condition: service_healthy
    environment:
      - BUILD=jwt
      - ENABLE_VNSTAT=true
      - HOST_HOSTNAME=${HOSTNAME}
      - URNETWORK_NODE_NAME=urfix-3
    volumes:
      - ur_config:/root/.urnetwork  # SHARED volume
      - urfix-3_vnstat:/var/lib/vnstat
      - ./proxy.txt:/app/proxy.txt
    ports:
      - "9003:8080"
    logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "3"

volumes:
  ur_config:      # Shared authentication session
  urfix-1_vnstat: # Unique traffic stats per node
  urfix-2_vnstat:
  urfix-3_vnstat:

🚀 Ready Templates

For larger stacks, these templates use YAML anchors to keep the files shorter while still being ready to copy.

Set URNETWORK_AUTH_CODE only on node-1. The other nodes wait for node-1 to write the shared JWT, then reuse it.

🖐️ 5 Nodes

x-urnetwork-common: &urnetwork-common
  image: ghcr.io/full-bars/meso-miner:latest
  restart: unless-stopped
  pull_policy: always
  cap_add: [NET_ADMIN, NET_RAW]
  sysctls:
    - net.ipv4.ip_forward=1
  logging:
    driver: json-file
    options:
      max-size: "10m"
      max-file: "3"

x-dependent-node: &dependent-node
  <<: *urnetwork-common
  depends_on:
    node-1:
      condition: service_healthy

services:
  node-1:
    <<: *urnetwork-common
    container_name: urfix-1
    environment:
      - BUILD=jwt
      - ENABLE_VNSTAT=true
      - HOST_HOSTNAME=${HOSTNAME}
      - URNETWORK_NODE_NAME=urfix-1
      - URNETWORK_AUTH_CODE=YOUR_AUTH_CODE
    volumes:
      - ur_config:/root/.urnetwork
      - urfix-1_vnstat:/var/lib/vnstat
      - ./proxy.txt:/app/proxy.txt
    ports:
      - "9001:8080"
    healthcheck:
      test: ["CMD-SHELL", "[ -s /root/.urnetwork/jwt ]"]
      interval: 5s
      timeout: 3s
      retries: 30
      start_period: 10s

  node-2:
    <<: *dependent-node
    container_name: urfix-2
    environment:
      - BUILD=jwt
      - ENABLE_VNSTAT=true
      - HOST_HOSTNAME=${HOSTNAME}
      - URNETWORK_NODE_NAME=urfix-2
    volumes:
      - ur_config:/root/.urnetwork
      - urfix-2_vnstat:/var/lib/vnstat
      - ./proxy.txt:/app/proxy.txt
    ports:
      - "9002:8080"

  node-3:
    <<: *dependent-node
    container_name: urfix-3
    environment:
      - BUILD=jwt
      - ENABLE_VNSTAT=true
      - HOST_HOSTNAME=${HOSTNAME}
      - URNETWORK_NODE_NAME=urfix-3
    volumes:
      - ur_config:/root/.urnetwork
      - urfix-3_vnstat:/var/lib/vnstat
      - ./proxy.txt:/app/proxy.txt
    ports:
      - "9003:8080"

  node-4:
    <<: *dependent-node
    container_name: urfix-4
    environment:
      - BUILD=jwt
      - ENABLE_VNSTAT=true
      - HOST_HOSTNAME=${HOSTNAME}
      - URNETWORK_NODE_NAME=urfix-4
    volumes:
      - ur_config:/root/.urnetwork
      - urfix-4_vnstat:/var/lib/vnstat
      - ./proxy.txt:/app/proxy.txt
    ports:
      - "9004:8080"

  node-5:
    <<: *dependent-node
    container_name: urfix-5
    environment:
      - BUILD=jwt
      - ENABLE_VNSTAT=true
      - HOST_HOSTNAME=${HOSTNAME}
      - URNETWORK_NODE_NAME=urfix-5
    volumes:
      - ur_config:/root/.urnetwork
      - urfix-5_vnstat:/var/lib/vnstat
      - ./proxy.txt:/app/proxy.txt
    ports:
      - "9005:8080"

volumes:
  ur_config:
  urfix-1_vnstat:
  urfix-2_vnstat:
  urfix-3_vnstat:
  urfix-4_vnstat:
  urfix-5_vnstat:

🔟 10 Nodes

x-urnetwork-common: &urnetwork-common
  image: ghcr.io/full-bars/meso-miner:latest
  restart: unless-stopped
  pull_policy: always
  cap_add: [NET_ADMIN, NET_RAW]
  sysctls:
    - net.ipv4.ip_forward=1
  logging:
    driver: json-file
    options:
      max-size: "10m"
      max-file: "3"

x-dependent-node: &dependent-node
  <<: *urnetwork-common
  depends_on:
    node-1:
      condition: service_healthy

services:
  node-1:
    <<: *urnetwork-common
    container_name: urfix-1
    environment:
      - BUILD=jwt
      - ENABLE_VNSTAT=true
      - HOST_HOSTNAME=${HOSTNAME}
      - URNETWORK_NODE_NAME=urfix-1
      - URNETWORK_AUTH_CODE=YOUR_AUTH_CODE
    volumes:
      - ur_config:/root/.urnetwork
      - urfix-1_vnstat:/var/lib/vnstat
      - ./proxy.txt:/app/proxy.txt
    ports:
      - "9001:8080"
    healthcheck:
      test: ["CMD-SHELL", "[ -s /root/.urnetwork/jwt ]"]
      interval: 5s
      timeout: 3s
      retries: 30
      start_period: 10s

  node-2:
    <<: *dependent-node
    container_name: urfix-2
    environment:
      - BUILD=jwt
      - ENABLE_VNSTAT=true
      - HOST_HOSTNAME=${HOSTNAME}
      - URNETWORK_NODE_NAME=urfix-2
    volumes:
      - ur_config:/root/.urnetwork
      - urfix-2_vnstat:/var/lib/vnstat
      - ./proxy.txt:/app/proxy.txt
    ports:
      - "9002:8080"

  node-3:
    <<: *dependent-node
    container_name: urfix-3
    environment:
      - BUILD=jwt
      - ENABLE_VNSTAT=true
      - HOST_HOSTNAME=${HOSTNAME}
      - URNETWORK_NODE_NAME=urfix-3
    volumes:
      - ur_config:/root/.urnetwork
      - urfix-3_vnstat:/var/lib/vnstat
      - ./proxy.txt:/app/proxy.txt
    ports:
      - "9003:8080"

  node-4:
    <<: *dependent-node
    container_name: urfix-4
    environment:
      - BUILD=jwt
      - ENABLE_VNSTAT=true
      - HOST_HOSTNAME=${HOSTNAME}
      - URNETWORK_NODE_NAME=urfix-4
    volumes:
      - ur_config:/root/.urnetwork
      - urfix-4_vnstat:/var/lib/vnstat
      - ./proxy.txt:/app/proxy.txt
    ports:
      - "9004:8080"

  node-5:
    <<: *dependent-node
    container_name: urfix-5
    environment:
      - BUILD=jwt
      - ENABLE_VNSTAT=true
      - HOST_HOSTNAME=${HOSTNAME}
      - URNETWORK_NODE_NAME=urfix-5
    volumes:
      - ur_config:/root/.urnetwork
      - urfix-5_vnstat:/var/lib/vnstat
      - ./proxy.txt:/app/proxy.txt
    ports:
      - "9005:8080"

  node-6:
    <<: *dependent-node
    container_name: urfix-6
    environment:
      - BUILD=jwt
      - ENABLE_VNSTAT=true
      - HOST_HOSTNAME=${HOSTNAME}
      - URNETWORK_NODE_NAME=urfix-6
    volumes:
      - ur_config:/root/.urnetwork
      - urfix-6_vnstat:/var/lib/vnstat
      - ./proxy.txt:/app/proxy.txt
    ports:
      - "9006:8080"

  node-7:
    <<: *dependent-node
    container_name: urfix-7
    environment:
      - BUILD=jwt
      - ENABLE_VNSTAT=true
      - HOST_HOSTNAME=${HOSTNAME}
      - URNETWORK_NODE_NAME=urfix-7
    volumes:
      - ur_config:/root/.urnetwork
      - urfix-7_vnstat:/var/lib/vnstat
      - ./proxy.txt:/app/proxy.txt
    ports:
      - "9007:8080"

  node-8:
    <<: *dependent-node
    container_name: urfix-8
    environment:
      - BUILD=jwt
      - ENABLE_VNSTAT=true
      - HOST_HOSTNAME=${HOSTNAME}
      - URNETWORK_NODE_NAME=urfix-8
    volumes:
      - ur_config:/root/.urnetwork
      - urfix-8_vnstat:/var/lib/vnstat
      - ./proxy.txt:/app/proxy.txt
    ports:
      - "9008:8080"

  node-9:
    <<: *dependent-node
    container_name: urfix-9
    environment:
      - BUILD=jwt
      - ENABLE_VNSTAT=true
      - HOST_HOSTNAME=${HOSTNAME}
      - URNETWORK_NODE_NAME=urfix-9
    volumes:
      - ur_config:/root/.urnetwork
      - urfix-9_vnstat:/var/lib/vnstat
      - ./proxy.txt:/app/proxy.txt
    ports:
      - "9009:8080"

  node-10:
    <<: *dependent-node
    container_name: urfix-10
    environment:
      - BUILD=jwt
      - ENABLE_VNSTAT=true
      - HOST_HOSTNAME=${HOSTNAME}
      - URNETWORK_NODE_NAME=urfix-10
    volumes:
      - ur_config:/root/.urnetwork
      - urfix-10_vnstat:/var/lib/vnstat
      - ./proxy.txt:/app/proxy.txt
    ports:
      - "9010:8080"

volumes:
  ur_config:
  urfix-1_vnstat:
  urfix-2_vnstat:
  urfix-3_vnstat:
  urfix-4_vnstat:
  urfix-5_vnstat:
  urfix-6_vnstat:
  urfix-7_vnstat:
  urfix-8_vnstat:
  urfix-9_vnstat:
  urfix-10_vnstat:

▶️ Start the Stack

From the folder containing your chosen docker-compose.yml:

docker compose up -d

✅ Verify

Check Node 1 logs to confirm first-time authentication:

docker logs urfix-1

List running containers:

docker compose ps

Check your Client Manager. You should see one entry per node, identified by the names in URNETWORK_NODE_NAME and a redacted public IP for privacy, for example:

urfix-1 @ 69.x.x.96 [v3.23.0-fix.15]
urfix-2 @ 69.x.x.96 [v3.23.0-fix.15]

📖 Navigation

🚀 Getting Started

⚙️ Configuration and Ops

🔍 Diagnostics and Reference

Clone this wiki locally