Skip to content

Mining Troubleshooting

This guide covers common mining issues and their solutions.

Common Issues

Miner Won't Start

Symptoms:

  • Miner crashes immediately
  • Error on startup
  • GPU not detected

Solutions:

bash
# Check GPU detection
nvidia-smi  # For NVIDIA
rocm-smi    # For AMD

# Update GPU drivers
# NVIDIA
sudo apt install nvidia-driver-535

# AMD
sudo amdgpu-install

# Check miner compatibility
./miner --help

Low Hash Rate

Symptoms:

  • Hash rate significantly below expected
  • Inconsistent performance

Solutions:

bash
# Check GPU temperature
nvidia-smi  # Should be below 80°C

# Check power limit
nvidia-smi -pl 200  # Set power limit

# Memory overclock (NVIDIA)
nvidia-settings -a "[gpu:0]/GPUMemoryTransferRateOffset[3]=1000"

# Check for thermal throttling
nvidia-smi -q -d TEMPERATURE

Expected Hash Rates:

GPUExpectedIf Lower
RTX 308050-55 Sol/sCheck temps, power limit
RTX 307038-42 Sol/sUpdate drivers
RX 6800 XT48-52 Sol/sCheck memory timings
RX 6700 XT33-37 Sol/sUpdate BIOS

High Temperature

Symptoms:

  • GPU temperature above 80°C
  • Thermal throttling
  • Miner crashes under load

Solutions:

bash
# Increase fan speed
# NVIDIA
nvidia-settings -a "[gpu:0]/GPUFanControlState=1"
nvidia-settings -a "[fan:0]/GPUTargetFanSpeed=80"

# AMD
rocm-smi --setfan 80

# Undervolt (NVIDIA)
nvidia-settings -a "[gpu:0]/GPUGraphicsClockOffset[3]=-100"

# Improve airflow
# - Clean dust from GPUs
# - Add case fans
# - Improve cable management

Rejected Shares

Symptoms:

  • High rejection rate
  • "Invalid share" errors
  • Pool rejects shares

Solutions:

  1. Verify Algorithm:
bash
# Ensure you're using ZelHash
./miner --algo zelhash ...
  1. Check Stratum Connection:
bash
# Test connection
nc -zv cs.miningtothelastblock.top 3333
  1. Update Mining Software:
bash
# Download latest version
wget https://github.com/develsoftware/GMinerRelease/releases/latest
  1. Check System Clock:
bash
# Sync time
sudo ntpdate pool.ntp.org

Connection Issues

Symptoms:

  • Cannot connect to pool
  • "Connection refused" errors
  • Frequent disconnections

Solutions:

bash
# Check firewall
sudo ufw status
sudo ufw allow 3333/tcp

# Test pool connectivity
ping cs.miningtothelastblock.top
nc -zv cs.miningtothelastblock.top 3333

# Try alternative pool
./miner --server cs.miningtothelastblock.top ...

# Check DNS
nslookup cs.miningtothelastblock.top

Worker Not Showing on Pool

Symptoms:

  • Mining but worker not visible on pool dashboard
  • No shares recorded

Solutions:

  1. Wait 5-10 minutes — Pools have delay
  2. Verify wallet address:
bash
# Check your address format
cs-cli getnewaddress
  1. Check worker name format:
Correct: wallet_address.worker_name
Incorrect: just_worker_name
  1. Verify shares are being submitted:
Look for "Share accepted" in miner output

GPU-Specific Issues

NVIDIA GPUs

CUDA Error:

bash
# Update CUDA drivers
sudo apt update
sudo apt install nvidia-cuda-toolkit

# Check CUDA version
nvcc --version

Out of Memory:

bash
# Reduce intensity
./miner --algo zelhash --intensity 20 ...

# Close other GPU applications
pkill -f "gpu_app"

AMD GPUs

OpenCL Error:

bash
# Install ROCm
sudo amdgpu-install --usecase=rocm

# Verify OpenCL
clinfo

Memory Timing Issues:

bash
# Use AMD Memory Tweak
memory-tweak -m 1  # For Samsung memory
memory-tweak -m 2  # For Hynix memory

System Issues

Out of Memory (RAM)

bash
# Check available RAM
free -h

# Increase swap
sudo fallocate -l 8G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

CPU Bottleneck

bash
# Check CPU usage
top

# Reduce miner CPU usage
./miner --algo zelhash --cpu-priority 2 ...

Disk Space

bash
# Check disk space
df -h

# Clean up
sudo apt clean
rm -rf /tmp/*

Advanced Troubleshooting

Enable Debug Logging

bash
# GMiner debug
./miner --log log.txt --debug ...

# T-Rex debug
./t-rex --debug ...

Network Diagnostics

bash
# Trace route to pool
traceroute cs.miningtothelastblock.top

# Check latency
ping cs.miningtothelastblock.top

# Test bandwidth
speedtest-cli

Performance Profiling

bash
# Monitor GPU performance
watch -n 1 nvidia-smi

# Monitor power consumption
nvidia-smi --query-gpu=power.draw --format=csv -l 1

Getting Help

Information to Provide

When asking for help, include:

  1. GPU model and count
  2. Mining software and version
  3. Operating system
  4. Error messages (full output)
  5. Pool being used
  6. Hash rate achieved vs expected

Support Channels


Next Steps

Released under the MIT License.