Updated

Goal: put your miners on Foreman's Site Map so your team can see where every miner physically sits and spot problems by location.
Time: 30 minutes to a few hours, depending on the method and the size of your site.

Before You Start

  • Finish Learning Path 1. Your miners should be reporting through Pickaxe.
  • You need the Edit Site Map permission. Viewing needs View Site Map.
  • Click Site Map in the left-hand menu and check which version your account shows:
    • Site Map Lite shows Miner Groups, each defined by IP ranges, with an Add Miner Group button.
    • The classic Site Map shows racks laid out on a grid, with each miner in a row and position.

Decisions to Make

  • Site Map Lite: how to group your miners, for example one group per container or building. Each group needs its own IP ranges that don't overlap with any other group.
  • Classic Site Map: how you'll tell Foreman where each miner is.
    • CSV upload, if you already track locations by IP or MAC address.
    • Interactive Fill, if a technician can walk the racks and press each miner's IP Report button.
    • Automatic, from managed switch ports or static IP addresses.

If You Have Site Map Lite

  1. On the Site Map page, click Add Miner Group.
  2. Enter a Name, choose the Pickaxe and Manufacturer, set the Expected Miners Count, and add the group's IP ranges. If you choose Antminer, also enter the miner username and password so the sync works.
  3. Save, then use Sync on the group to pull in current stats.
  4. Click into a group to see its miners. From a miner's Actions menu you can blink LEDs, reboot, pull the miner, and more.

More: Quick Guide: Site Map Lite.

If You Have the Classic Site Map

Option A: Upload a CSV

  1. On the Site Map page, download the location template By IPs or By MACs, whichever matches how you track miners.
  2. Fill in each miner's rack, row and position, then upload the file. Foreman checks the file and shows a preview of the changes before applying them.

Onboarding: Upload Locations

More: How To: Create Site Map With CSV Upload.

Option B: Interactive Fill

  1. Click a rack and choose Interactive Fill, then select the Pickaxe that will listen for IP Report broadcasts.
  2. Walk the rack in order and press the IP Report button on each miner. Each one is placed in the next position.

Onboarding: Interactive Fill on a rack

More: How To: Populate My Site Map Using Interactive Fill.

Option C: Automatic placement

If your miners sit on managed switch ports or use static IP addresses tied to their position, Foreman can place them automatically. See How To: Automatically Populate Your Site Map and How To: Generate A Site Map Using Static IP Addresses.

Keep it accurate

  • Disable any location that can't hold a miner, such as a broken PDU outlet. Click the location, choose Disable Location and add a note. Foreman then won't place miners there.
  • Choose how the map is colored (Heat, Hash Rate or Power Mode) in My Account > Site Map Display Preference.
  • When a miner leaves its rack for repair, use Pull Miner so the map, the miner's state and its ticket stay in step.

Onboarding: Site Map status colors

Done When

  • ☐ Every rack or group on your site is on the Site Map.
  • ☐ Miners show in the right place, and you can click through to their details.
  • ☐ Your team knows how to keep the map current when miners move.

Next

Module 2: Setting Up Alerts and Triggers: get alerted to problems and fix common ones automatically.

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