Every miner in Foreman has a state that says where it is in its life: on the rack, in the shop, in storage or retired. This guide explains each state and which action to use when a miner leaves or returns to service. It's for operators and technicians who move miners.
Miner States
| State | Meaning | Enabled? | Shown by default on the Dashboard and Miners page? | Site Map |
|---|---|---|---|---|
| Deployed | On the rack and hashing, or trying to. | Yes | Yes | Keeps its location |
| In Repair | Off the rack for repair and expected back. | No (disabled automatically) | Yes | Shown as disabled. A pulled miner's location is cleared. |
| In Storage | Working but not deployed. | No (disabled automatically) | No. Filter by Miner State to see it. | Not on the map once pulled |
| Retired | Leaving the fleet for good. | No (disabled automatically) | No. Filter by Miner State to see it. | Removed from the map |
A miner's state is shown in the header of its details page, in the State column on the Miners page, in miner exports and in the API.
State vs. status: state is where the miner is in its life. Status (Healthy, Warning, Danger, Disabled, Pending) is how it's running right now. See Quick Guide: Issues.
Which Action to Use
| Situation | Use |
|---|---|
| Taking a miner off the rack for repair, storage or retirement | Pull Miner. It disables the miner, clears its Site Map location, and sets its state, offline location and ticket in one step. See How To: Pull A Miner Out Of Service. |
| A miner will be offline for a while but stays in place | Disable (below) |
| The miner's control board was replaced, so it reports as a new device | Replace, so the old record's history and linked asset carry over. See How To: Replace A Miner After A Control Board Change. |
| Changing the state of many miners at once | Bulk Edit Miners on the Miners page |
| Removing a miner record completely | Delete. This removes its historical data, so pull or retire the miner instead if you want to keep its history. |
Disable or Enable a Miner
Disabling tells Pickaxe not to expect the miner on the network. Its data is kept.
- Go to Miners and open the miner's Actions menu.
- Choose Disable and confirm. Choose Enable to bring it back.
To disable or enable many miners, use Bulk Edit Miners. To re-enable miners automatically when they show up on the network again, turn on Automatically Enable Matched Disabled Miners on a recurring re-sync scan. See How To: Make Foreman Update IPs Automatically.
Returning a Miner to Service
- Put the miner back on the Site Map, for example with Interactive Fill or a location upload.
- Enable the miner, and set its state to Deployed in the miner's Settings.
- Close the repair ticket, if there is one.
Related Articles
Last verified: November 19, 2026