Quick Guide: Miner States And Lifecycle

Updated

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.

  1. Go to Miners and open the miner's Actions menu.
  2. 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

  1. Put the miner back on the Site Map, for example with Interactive Fill or a location upload.
  2. Enable the miner, and set its state to Deployed in the miner's Settings.
  3. Close the repair ticket, if there is one.

Related Articles

Last verified: November 19, 2026

Was this article helpful?

1 out of 1 found this helpful

Have more questions? Submit a request

Can't find what you're looking for?

Our support team can help with setup, hardware and billing questions.

Contact Support