How To: Pull A Miner Out Of Service

Updated

Use Pull Miner when you take a miner off its rack, for repair, storage or retirement. In one step it disables the miner, removes it from its Site Map location, and records where it went. You can set its state, assign an offline location and open a ticket at the same time, so the miner's history stays complete.

Before You Start

  • You need permission to edit the Site Map and the miner (Edit Site Map and Edit Miners). Opening a ticket also needs Edit Tickets.
  • The miner must have a location on the Site Map.
  • Assigning an offline location needs the Assets & Inventory module, and only applies to miners linked to an asset. See Quick Guide: Offline Locations.

Pull One Miner

  1. Go to Site Map in the left-hand menu and find the miner.
    • Classic Site Map: click the miner's location to open its menu.
    • Site Map Lite: open the miner's group, then the miner's Actions menu.
  2. Choose Pull Miner.
  3. In the dialog, choose the state the miner should be left in:
    • In Repair: going to be fixed and will come back.
    • In Storage: working, but not deployed for now.
    • Retired: leaving the fleet for good.
  4. Optional: choose an Offline Location, such as a repair shelf or pallet.
  5. Optional: open a new ticket for the work, or link the pull to an existing ticket.
  6. Confirm.

Pull Many Miners at Once

  1. Go to Miners, filter to the miners you want, and click Bulk Edit Miners.
  2. Select the miners, click Edit (#), and choose Pull Miners.
  3. Choose the state, an offline location if needed, and whether to create a ticket or link to an existing one. Then apply.

Bulk pull only works if every selected miner has a Site Map location. If you check the box to create a ticket, Foreman opens a new ticket with the pulled miners already added.

What Happens When You Pull a Miner

  • The miner is disabled, so Pickaxe stops expecting it on the network and it no longer counts as offline.
  • Its Site Map location is cleared, ready for a replacement.
  • The miner keeps its history. Its state, offline location and any ticket are recorded, and the change appears in the Audit Log.
  • Miners that are In Storage or Retired are hidden from the Dashboard and the default Miners view. Use the Miner State filter to see them.

Bringing a Miner Back

When the miner is ready to go back on a rack, put it back in its location (for example with Interactive Fill), enable it, and set its state to Deployed. If its control board was replaced, use Replace instead. See How To: Replace A Miner After A Control Board Change.

Related Articles

Last verified: November 19, 2026

Was this article helpful?

0 out of 0 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