Sync links your assets to the miners and infrastructure in Foreman, and creates assets for any miners or devices that don't have one yet. Run it after you upload assets, add miners, or change how assets link to miners.
Before You Start
- You need the Edit Assets permission.
- Set how assets match miners under Settings > Assets > Asset Miner Link > Link On (Miner Serial, Miner Mac or Miner Custom Field Name). See How To: Link An Asset To A Miner.
Run a Sync
- Go to Operations > Assets in the left-hand menu.
- Click Sync Assets. On the new Assets page, click Sync Now in the Linked Assets tile at the top.
- Choose what to sync: miners and infrastructure (Both), Miners only, or Infrastructure only.
- Confirm. The sync runs in the background, and Foreman notifies you when it's finished.
What a Sync Does
- Links each unlinked asset to the miner or device whose serial, MAC or custom field matches its Asset ID.
- Creates and links a new asset for any miner or device that doesn't have one.
- For multi-site and colocated setups, includes the miners the client can see, not only those assigned directly to the site client.
If Some Miners Can't Be Synced
If a miner can't be created or linked, for example because it has no serial number or it's already linked to another asset, Foreman lets you know and you can download a list of exceptions. Work through that list, then sync again. For help with common causes, see Common Troubleshooting: Unlinked And Mismatched Assets.
Last verified: November 20, 2026