When a miner's control board is replaced, it can report to Foreman as a new device. Use Replace to move the old miner record's history and linked asset over to the new one, instead of ending up with two records.
Before You Start
- You need the Edit Miners permission. To add the replacement, you also need Add Miners.
- If the miner has already left the rack, it should have been pulled with Pull Miner and set to In Repair. See How To: Pull A Miner Out Of Service. If it's still in place, set its state yourself:
- On the Miners page, open the miner's Actions menu and choose Settings.
- Set State to In Repair, confirm, and save.
Replace the Miner
- When the repaired miner is ready, open the old miner's Actions menu and choose Replace.
- Click Skip and Add Manually.
- Enter the new miner's details and click Next.
- Choose what should happen to the old miner record, then click Replace.
What You Should See
The new miner appears on the Miners page with the old record's history and linked asset. Set its state to Deployed once it's back on the rack.
Related Articles
Last verified: November 19, 2026