Goal: configure Assets & Inventory for your organization before you load any data, so every record you add later lands in the right type, with the right fields, linked to the right miner.
Time: about 30 minutes.
Before You Start
- You need the Admin role, or the Asset Manager and Inventory Manager permissions.
- Asset and inventory settings live in Settings: open the user menu (top right) and select Settings, then choose the Assets or Inventory tile.
- If you track equipment in a spreadsheet today, have it open. Its columns tell you which types and custom fields you need.
Decisions to Make
- Who does what. Decide who configures settings, who adds and edits records, and who uses parts on tickets.
- How assets match miners. Pick the identifier that's most complete and accurate in your records: serial number, MAC address, or one of your miner custom fields.
- What extra data you track. For example: purchase date, supplier, PO number or warranty provider.
- Who hears about low stock. Choose the email addresses that should get low-inventory notifications.
Step 1: Give Your Team the Right Permissions
Open the user menu and select Users, then go to the Roles tab. Add these permissions to the roles that need them:
| Permission | What it allows | Typical role |
|---|---|---|
| Asset Manager | Manage asset settings, such as asset types and fields, and create or edit offline locations | Administrator |
| Inventory Manager | Manage inventory settings, such as inventory types and fields, and create or edit offline locations | Administrator |
| Edit Assets | Create and edit assets, including assigning offline locations | Operations lead, technician |
| Edit Inventory | Create and edit inventory items | Operations lead, parts coordinator |
| Edit Tickets | Create and edit tickets, including adding parts to them | Technician |
For every permission, see Quick Guide: Roles And Permissions.
Step 2: Set Up Asset Types and Fields
- Go to Settings and select the Assets tile.
- Under Asset Types, review the built-in types (ASIC Miner, GPU Miner and Infrastructure Component). Click Add Type for anything else you track, such as Hash Board or Control Board.
- Under Asset Fields, click Add Field for each extra piece of data. Choose a field type: Date, Date and Time, Text, Number or Choice. For Choice fields, click Add Choice for each option.
- If you manage sub-clients, turn on Show on Sub-Clients for fields they should see.
- Click Save.
To delete a custom type later, first move every asset using it to another type. Details: How To: Create A Custom Asset Field.
Step 3: Choose How Assets Link to Miners
On the same page, under Asset Miner Link, set Link On to one of these:
- Miner Serial: the best choice for most sites. Serial numbers come from the manufacturer and don't change, but they must be recorded accurately.
- Miner Mac: Foreman reads MAC addresses automatically, so there's nothing to type. A MAC can change if a control board is replaced, which breaks the link.
- Miner Custom Field Name: use your own tag, such as an internal asset number. Choose the field in Custom Field Name. That field must be filled in on every miner.
Click Save. If you change this later, use Sync Assets on the Assets page to re-link everything (see Module 2).
Step 4: Set Up Inventory Types and Fields
- Go to Settings and select the Inventory tile.
- Under Inventory Types, click Add Type for each category of part, such as Fans, PSUs, Cables or Hash Boards. There are no built-in inventory types.
- Under Inventory Fields, click Add Field for extra data, such as supplier or part number. The field types are the same as for assets.
- Click Save.
Details: How To: Set Up Inventory Types And Inventory Fields.
Step 5: Set Up Low-Inventory Emails
- On the Inventory settings page, find Low Inventory Notification Emails.
- Enter the email addresses that should be notified.
- Click Save.
Emails go out when an item's quantity drops below its own notification threshold, which you set on each item in Module 3.
If Something Isn't Working
- A new field doesn't appear: refresh the page. For sub-clients, check that Show on Sub-Clients is on.
- You can't delete a type: some assets or items still use it. Move them to another type first.
- You don't see the Assets or Inventory tiles: your role needs Asset Manager or Inventory Manager.
Done When
- ☐ Each role on your team has the Assets & Inventory permissions it needs.
- ☐ Asset types and fields match what you track.
- ☐ Link On is set and saved.
- ☐ Inventory types and fields are created.
- ☐ Low-inventory notification emails are saved.
Next
Continue with Module 2: Set Up Assets.
Last verified: November 19, 2026