simeononsecurity/hellminer repository overview

⁠Hellminer Docker Container

This repository provides a Docker container for Hellminer, an optimized CPU miner for Verus Coin (VRSC). The container is based on Ubuntu and includes all necessary dependencies to start mining immediately.

⁠Features

• Supports stratum+tcp and stratum+ssl connections.
• Defaults to stratum+ssl with port 3958.
• Configurable wallet, worker name, CPU count, and pool connection.
• Exposes an optional API for monitoring.
• Includes a built-in health check to ensure the miner is running.
• Allows selection of optimized miner binaries (AVX or AVX2).
• Lightweight and minimal dependencies.

⁠Usage

⁠Pull the Docker Image

docker pull simeononsecurity/hellminer:latest

⁠Run the Miner

docker run -itd \
  -e STRATUM="stratum+ssl" \
  -e URL="na.luckpool.net" \
  -e PORT=3958 \
  -e WALLET="R9SWmsN6Dq1ocqkeB9GUVwP4RGMXt2mNLf" \
  -e WORKER="SimeononSecurityMadeMe" \
  -e CPU=2 \
  -e API_PORT=8080 \
  -e API_PASS="" \
  -e ARCH_TYPE="hellminer_linux64.tar.gz" \
  --name verusminer \
  simeononsecurity/hellminer:latest

⁠Selecting the Miner Version

The ARCH_TYPE variable allows you to choose between different optimized miner binaries:

To use an AVX-optimized version, set ARCH_TYPE like this:

docker run -itd \
  -e ARCH_TYPE="hellminer_linux64_avx.tar.gz" \
  simeononsecurity/hellminer:latest

To use AVX2, simply change:

docker run -itd \
  -e ARCH_TYPE="hellminer_linux64_avx2.tar.gz" \
  simeononsecurity/hellminer:latest

If an invalid value is provided, the default (hellminer_linux64.tar.gz) will be used.

⁠Configuration Options

⁠Exposed Ports

• ${PORT} (Mining Pool Connection)
• ${API_PORT} (Monitoring API, if enabled)

⁠Health Check

The container includes a health check that verifies if hellminer is running:

• Starts checking after 60 seconds.
• Runs every 5 seconds.
• If the miner is not running, the container is marked as unhealthy.

To check the health status:

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

⁠Monitoring API

The miner supports an HTTP API for monitoring when API_PORT is set.

http://localhost:8080/

Set API_PASS for secured access to http://localhost:8080/admin.

⁠Stopping the Miner

docker stop verusminer

⁠Removing the Container

docker rm verusminer

⁠Explore the World of Cybersecurity

  ⁠

⁠Links:

• ⁠github.com/simeononsecurity⁠

• ⁠simeononsecurity.com⁠