Installation guide

How to install VNISH firmware safely

A safe VNISH install is a sequence, not a download button: identify hardware, check stock firmware date, choose SD or NAND, verify checksums, flash a pilot unit and only then scale across the farm.

SD recoveryNAND installVOU updateVOU
StepActionDo not skip
1Back up pools, workers, IP settings and current firmware infoYou may need this after recovery
2Identify exact model and control boardWrong board type is the most common install failure
3Check Bitmain stock firmware dateSome builds require recovery before VNISH
4Verify checksum and package typeInstall and update packages are different
5Flash one pilot miner firstBulk deployment should follow proof of stability

SD card method

Use SD when the miner needs recovery, when stock firmware blocks direct install or when you want a reversible first boot path. Format the card correctly and use the model-specific recovery image.

NAND method

Use NAND for production after compatibility is clear. NAND writes internal storage and should be done only with the correct model, board and package.

Bulk deployment

For farms, separate miners by model, board type, firmware state and cooling type. Run one rack only after a pilot miner survives a complete autotune cycle.

Frequently asked questions

What is the safest VNISH install method?+

SD recovery is safest for uncertain miners. NAND is best for stable production once compatibility is confirmed.

Can I update stock Bitmain firmware directly to VNISH?+

Sometimes, but not always. Stock firmware date and control board determine whether direct install is allowed.

What should I do before bulk flashing?+

Test one miner, export settings, verify temperatures and keep rollback/recovery available.

Related VNISH guides

Continue through the model, install and recovery pages before flashing production miners.