Goal: get every piece of hardware you want to track into Foreman, linked to its miner where there is one, so each asset's location, state and history stay current without manual updates.
Time: 20–45 minutes, depending on how many assets you have.
Before You Start
- Finish Module 1. Your asset types, custom fields and Link On setting need to be in place first.
- You need the Edit Assets permission.
- Go to Operations > Assets in the left-hand menu. The page has View History, Upload Assets, Sync Assets and Add Asset buttons above the table.
Decisions to Make
- What counts as an asset. Anything you track one at a time by its own ID: miners, hash boards, control boards, PDUs, transformers and other infrastructure. Parts you count by quantity belong in Inventory (Module 3).
- Your Asset ID. Use the same value you chose for Link On, such as the serial number, so assets link to their miners automatically.
- How to load them. Use Sync Assets to create assets from the miners and infrastructure already in Foreman. Use Upload Assets for a spreadsheet. Use Add Asset for one item at a time.
Step 1: Create Assets From Your Existing Miners
If Pickaxe is already reporting your fleet, let Foreman create your assets for you:
- Click Sync Assets.
- Choose what to sync: Both Miners and Infrastructure, Miners Only or Infrastructure Only.
- Confirm. Foreman links any unlinked assets that match a miner or device, and creates assets for miners and infrastructure that don't have one yet.
On the new Assets page, which is being turned on for accounts in stages: the button is Sync Now, in the Linked Assets tile at the top of the page. It has the same choices: Both, Miners or Infrastructure.
Run Sync Assets again any time you add miners or change your Link On setting. Details: How To: Sync Assets.
Step 2: Upload the Rest From a Spreadsheet
- Click Upload Assets and choose CSV Upload.
- Click Download next to Current Assets to get a CSV of everything already in Foreman, with every available column. Edit that file rather than starting from scratch.
- Every row needs an Asset ID and a Type. The type must exactly match one from Settings.
- Decide on Partial Upload (see the warning below), then upload your file.
- Review the confirmation screen. It shows how many assets will be updated, created and deleted. Click Confirm only if those numbers look right.
⚠️ Important: with Partial Upload turned off, the file replaces your whole asset list, and any asset that isn't in the file is deleted. Turn on Partial Upload when your file only has new or changed assets.
If any rows have problems, Foreman lists them under Errors in Upload. For example: "Row 4: missing 'Asset ID' or 'Type' column", or "Row 9: Type: PSU is not a valid option". Fix those rows and upload again.
Text Upload is a quick alternative for many assets of the same type. Choose a type, then paste the Asset IDs separated by commas or new lines.
Details: How To: Upload Assets.
Step 3: Add Single Assets
- Click Add Asset.
- Fill in Asset ID and Type (both required), plus Name, Client and Warranty Expiration Date if you have them.
- To link it to a miner now, search for the miner in Linked Item.
- If it's sitting on a shelf or a repair bench, choose an Offline Location (Module 4 covers these).
- Click Save.
Details: How To: Add An Individual Asset and How To: Link An Asset To A Miner.
Step 4: Clean Up Unlinked and Mismatched Assets
On the new Assets page, the View Unlinked Now and View Mismatched Now shortcuts in the tiles at the top apply these filters for you.
- Open the filters and set Status to Unlinked, then click Filter. These assets didn't match any miner. Common causes are a typo, an extra space, or a miner that isn't reporting yet.
- Fix the Asset IDs (or the miner's field), then run Sync Assets again.
- Set Status to Mismatched. These assets are linked, but their Asset ID or client no longer matches the miner, for example after a control board swap or a client change. Edit each asset to correct it.
Step 5: Learn the Assets Table
- Filters: narrow the table by Clients, Linked States (Deployed, In Repair, In Storage, Retired), Type, Location, Location Tags, Status, Ticket ID, Warranty Status, warranty dates, your custom fields, or a pasted list of Asset IDs.
- Bulk Edit: select several assets to update their custom fields or offline location, open a ticket for all of them, unlink them, or delete them.
- Row actions: edit an asset, view its open or past tickets, or open its history.
- History: View History shows every change to every asset. An asset's own history shows its changes, including when it was added to or removed from a ticket.
- Export: the Export link below the table downloads the assets that match your current filters.
Warranty tracking: Quick Guide: Asset Warranty Expiration. Full page reference: Quick Guide: Assets.
Done When
- ☐ Every asset you track is in Foreman with an Asset ID and type.
- ☐ Filtering by Status: Unlinked shows only assets that shouldn't be linked, such as spares.
- ☐ Filtering by Status: Mismatched shows nothing.
- ☐ You've opened the history for at least one asset.
Next
Continue with Module 3: Set Up Inventory.
Last verified: November 19, 2026