How to configure Iron Fish mining on Windows? (GPU Setup)

Understanding Iron Fish GPU Mining Requirements

1. Iron Fish relies on the Poseidon hash function, which is memory-hard and benefits significantly from high-bandwidth GPU memory.

2. NVIDIA GPUs with compute capability 6.0 or higher—such as GTX 1060 (6GB), RTX 2060, RTX 3070, and newer—are officially supported for optimal throughput.

3. AMD GPUs like RX 580, RX 6700 XT, and Radeon Pro W6800 are compatible but require ROCm-enabled drivers and manual OpenCL tuning.

4. At least 8GB of system RAM and 20GB of free SSD space are mandatory to store the full node database alongside mining binaries.

5. Windows 10 22H2 or Windows 11 23H2 is required; older builds lack necessary WDDM 3.0 and DirectX 12 Ultimate features needed for kernel-level GPU scheduling.

Driver and Runtime Environment Setup

1. Download and install the latest Game Ready Driver from NVIDIA’s official site—version 551.86 or newer ensures proper CUDA 12.6 support for Iron Fish’s native miner binary.

2. Disable Windows Hardware-accelerated GPU scheduling in Graphics Settings to prevent context-switching conflicts during continuous hashing cycles.

3. Install Visual C++ Redistributable for Visual Studio 2022 (x64) and .NET 6.0 Desktop Runtime—both are hard dependencies for the ironfish-miner.exe process.

4. For AMD users, install AMD Adrenalin 24.5.1 or later and enable OpenCL 3.0 via AMD Software: Adrenalin Edition > Graphics > Advanced > OpenCL Support.

5. Confirm driver installation by running nvidia-smi or clinfo in PowerShell—output must list active devices with compute capability and memory bandwidth metrics.

Node Synchronization and Miner Configuration

1. Clone the official Iron Fish repository using Git for Windows and execute npm run build inside the packages/miner directory to generate platform-specific binaries.

2. Launch ironfish start in a separate terminal window and wait until sync status shows “Synced: true” and block height matches the network tip reported at explorer.ironfish.network.

3. Create a miner-config.json file specifying gpuDeviceIndex, maxMemoryPercent, and useOpenCL flags—values must align with detected device enumeration order from nvidia-smi -L.

4. Set environment variable IRONFISH_MINER_CONFIG_PATH to the absolute path of the config file before invoking the miner binary.

5. Run ironfish-miner.exe --config miner-config.json and monitor real-time hashrate via the embedded HTTP endpoint at http://localhost:8888/metrics.

Performance Tuning and Stability Checks

1. Use MSI Afterburner to lock GPU core clock at +125MHz and memory clock at +1100MHz—this configuration delivers consistent gains across RTX 3080 and RX 6800 XT units without thermal throttling.

2. Limit power limit to 85% of TDP to reduce voltage spikes and extend VRAM longevity during multi-day mining sessions.

3. Enable persistent mode on NVIDIA GPUs via nvidia-smi -pm 1 to avoid driver reload delays after idle periods.

4. Monitor VRAM temperature continuously using HWiNFO64; sustained readings above 92°C indicate insufficient airflow or degraded thermal paste.

5. Validate stability by running ironfish-miner.exe --benchmark for 15 minutes—any crash or hash drop exceeding 8% signals misconfigured memory timings or driver incompatibility.

Frequently Asked Questions

Q: Does Iron Fish mining work on integrated Intel Arc GPUs?A: No. Integrated Arc GPUs lack sufficient VRAM bandwidth and do not expose the required OpenCL extensions for Poseidon kernel execution.

Q: Can I mine Iron Fish using WSL2 with GPU passthrough?A: Not supported. Windows Subsystem for Linux does not expose direct GPU access to user-space miners; only native Windows binaries are validated.

Q: Why does ironfish-miner.exe terminate immediately after launch?A: This occurs when Visual C++ 2022 Redistributable is missing or when the node process is not already running and fully synced—both conditions are enforced at startup.

Q: Is overclocking the GPU memory safe for long-term Iron Fish operations?A: Yes, if voltage remains within factory spec and VRAM junction temperature stays below 95°C. Exceeding these thresholds accelerates memory cell degradation.