Goal: map every place equipment sits when it isn't racked and running, such as repair benches, storage rooms, shelves and shipping areas, so you always know where a pulled miner or a spare part is.
Time: 15–30 minutes.
Before You Start
- To create, edit or delete locations, you need the Asset Manager or Inventory Manager permission. Other users with Assets & Inventory can view them. To put assets in a location, you need Edit Assets.
- Go to Operations > Offline Locations in the left-hand menu.
- Walk your site, or list your storage and repair areas, before you start.
Decisions to Make
- How detailed to go. One location per room is quick to set up. One per shelf, cart or pallet tells you exactly where things are. Start at the level your team will actually keep up to date.
- Location types. Each location is a Room, Pallet, Cart, Box, Shelf or Other.
- Tags. Use Location Tags to group locations across types, for example "Building A", "RMA" or "Ready to Deploy".
- Capacity. If a cart or shelf can only hold so many items, give it a Max Item Limit.
- Client. Every location belongs to a client. Hosting providers can keep each customer's equipment in its own locations.
Step 1: Add Locations in Bulk
- Click the arrow next to Add Offline Location and choose Bulk Add Offline Locations. Download the CSV template from the modal.
- Build a CSV with at least Location Name and Location Type columns. Optional columns:
-
Tags: separate several tags with a pipe, for example
Building A|RMA. - Max Item Limit: a number. Leave it blank or enter 0 for no limit.
- Client ID: leave it blank to use the client you're viewing.
-
Tags: separate several tags with a pipe, for example
- Click Upload CSV File, select your file, then click Add Offline Locations. If a row is missing a required field, you'll see an error before anything is created.
Step 2: Add Single Locations
- Click Add Offline Location.
- Enter a Name, choose the Client and Location Type, and add any Location Tags.
- To cap capacity, turn on Limit number of Items and enter a Max Item Limit.
- Save.
To create several similar locations, such as Shelf A1, A2 and A3, use Duplicate on an existing row and change the name.
Step 3: Put Equipment in a Location
- Pulling a miner off the rack: follow How To: Pull A Miner Out Of Service. The miner needs a linked asset (Module 2) to be given an offline location.
- Any asset: edit the asset on the Assets page and choose an Offline Location. If the asset is linked to a miner, Foreman disables that miner while it's in the location. Use Change State to mark it In Repair, In Storage or Retired at the same time.
- Many assets at once: use Bulk Edit on the Assets page and choose Offline Location.
- Inventory: set an item's Offline Location when you add or edit it.
Step 4: Keep Locations Tidy
- The table shows each location's Max Item Limit, Current Item Count and Remaining space. A location at its limit shows as Full.
- You can only delete a location once it's empty. Move its assets somewhere else first.
Full page reference: Quick Guide: Offline Locations.
Done When
- ☐ Each storage, repair and shipping area has an offline location with the right type and client.
- ☐ Capacity limits are set where space is limited.
- ☐ You've moved one test asset into a location and back out again.
Next
Continue with Module 5: Managing Assets and Inventory within Tickets.
Last verified: November 19, 2026