An asset is linked when it's matched to a miner or infrastructure device in Foreman. Linking keeps the asset's location and state in step with the miner. This article explains why assets end up unlinked or mismatched, and how to fix them.
Find Unlinked and Mismatched Assets
- On Operations > Assets, open the filters and set Status to Unlinked or Mismatched, then click Filter.
- On the new Assets page, the Linked Assets and Mismatched Linked Assets tiles at the top show the counts, with View Unlinked Now and View Mismatched Now shortcuts.
Why an Asset Is Unlinked
Foreman links an asset when its Asset ID matches the miner field chosen in Settings > Assets > Asset Miner Link > Link On: Miner Serial, Miner Mac or Miner Custom Field Name. Common reasons it doesn't match:
| Cause | Fix |
|---|---|
| A typo or extra space in the Asset ID | Edit the asset and correct the Asset ID, then sync. |
| The miner doesn't have the field filled in, for example no serial number or an empty custom field | Add the value to the miner, then sync. |
| The Asset ID uses a different identifier from Link On, for example a serial number while Link On is set to Miner Mac | Change Link On or the Asset IDs so they use the same identifier, then sync. |
| The miner isn't in Foreman yet, or isn't reporting | Add the miner (see How To: Add A Miner), then sync. |
| The asset isn't a miner or device at all, such as a spare part you track by ID | No fix needed. It's expected to stay unlinked. |
After fixing, run a sync. See How To: Sync Assets.
Why an Asset Is Mismatched
A mismatched asset is linked to a miner, but something no longer lines up. Foreman flags three conditions:
- Mismatched Link: the linking value doesn't match the Asset ID any more. Foreman shows the correction, for example "Current Asset ID: SN-1234 should be SN-5678". This often happens after a control board swap when you link by MAC address.
- Mismatched Client: the asset is on a colocated client but the miner is on the parent client. Foreman shows "Current Asset Client: X should be Y".
- Mismatched Client: the asset is on one colocated client but the miner is on a different colocated client.
To fix a mismatch, edit the asset and update the Asset ID or Client to what Foreman shows. If the asset is linked to the wrong miner, use Bulk Edit > Unlink, then link it again. If a control board was replaced, see How To: Replace A Miner After A Control Board Change.
If Sync Reports Exceptions
When a sync can't create or link some miners, for example a miner with no serial number or one that's already linked to another asset, you can download the list of exceptions. Fix each one using the tables above, then sync again.
Related Articles
Last verified: November 20, 2026