Contact Sales

Workers

Overview

The Workers list shows every mining device in your fleet in one table. Use it to monitor hashrate, power, temperature, and status, find workers with filters and search, and run actions on one worker or thousands at once.

Click a worker to open its Worker Details page.

Workers list with numbered page elements

#ElementDetails
1Workers in the main menuOpens the list
2SummarySummary
3Table headerColumns, Sorting and Paging
4Search fieldSearch
5Export buttonExport to CSV
6Table settings buttonColumns
7Filters buttonFilters

Access and Permissions

  • Provider Admin can view and manage every worker in the organization.
  • Provider Account with access to the Workers component can view and manage the workers of the Locations the account is restricted to. The list, summary, export, and bulk actions apply to those Locations only.
  • Customer accounts can view their own workers and export a reduced set of columns. Customers cannot run actions, and they keep the basic filter panel without saved filters.

Workers Table

Summary

The summary (2) shows Workers Count, Current Hashrate per algorithm, Current Power, Temperature, and Est. Efficiency. It always reflects the workers that match your current filters and search.

Columns

  • Click the table settings button (6) to choose which columns to show and in which order. Braiins Manager saves your column setup to your account.
  • Optional columns include Connectivity Status, Hostname, Pool URL, Fan Speeds, Errors, Advanced Settings, Hashing Uptime and System Uptime, the inlet, outlet, and threshold temperatures, and cooling and fan settings.
  • Hover a Pool Username cell to see the other configured pools of that worker.
  • Click an Errors cell to open a side panel with the active Braiins OS error codes of that worker.
  • Hashing and connectivity states are explained in Statuses.

Sorting and Paging

  • The table opens sorted by IP address, ascending, with 50 workers per page.
  • Click a column header (3) to sort by that column. MAC address, serial number, and firmware version cannot be sorted.

The search field (4) matches part of the IP address, MAC address, hostname, pool username, control board serial number, hashing status, connectivity status, or firmware version.

Filters

Click the filters button (7) to open the Filters panel. The panel has two tabs, Quick and Saved, and a Filter Builder link in its header.

Customer accounts see a single list of filter categories with Reset All. Saved filters and the Filter Builder are available to Provider Admin and Provider Accounts only.

Quick Filters

The Quick tab offers 14 categories:

AreaCategories
StatusHashing Status, Connectivity Status, Errors, Error Code
Hardware and firmwareDevice Model, Algorithm, Firmware, BOS License, Cooling Mode, Advanced Settings
Placement and ownershipLocation, Group, Rack, Customer

How Quick filters work:

  • A selection applies immediately.
  • Values within one category are joined with OR. Categories are joined with AND.
  • Device Model, Location, Group, Rack, and Customer have a search box for long lists.
  • The toolbar shows a chip such as "2 Active Filters". Clear the chip, or click Reset All in the panel, to remove every filter.
  • A filter change returns the table to page 1 and clears your row selection.

Saved Filters

The Saved tab lists the saved filters you can see. An icon on each row shows its scope: Personal, Location, or Company. Hover a row to see its owner, the last update, its scope, and the conditions it contains.

Saved tab of the Workers filter panel

To apply a saved filter, click its row. The toolbar shows a chip with the filter name.

  • Only one saved filter applies at a time. Clicking another one replaces it.
  • A saved filter and Quick filters do not combine. Applying a saved filter clears your Quick selections, and selecting a Quick filter removes the saved filter.
  • Clearing the chip or clicking Reset All removes the filter from the table. The saved filter itself stays in the Saved tab.
  • The applied filter is kept when you reload the page.

Create a Filter With the Filter Builder

The Filter Builder combines conditions on almost any column into one filter that you can save and reuse.

Filter Builder with three conditions

  1. In the filter panel, click Filter Builder.
  2. Enter a Filter Name of 3 to 100 characters. A name that already exists shows a warning but does not block saving.
  3. Choose who can see the filter in Scope Access:
    • Personal (default): only you.
    • Location: Provider Admins and Provider Accounts with access to at least one of the Locations you select in Share with locations.
    • Company: everyone in your organization. Only a Provider Admin can save a Company filter.
  4. In the first condition row, select a field, an operator, and a value.
  5. Click + Add Filter to add more rows. Rows are joined with AND. Several values in one row are joined with OR.
  6. Check Filtered Results, which shows how many workers match the conditions right now.
  7. Click Save Filter. Braiins Manager saves the new filter and applies it.

A shared filter never widens anyone's access. Each reader sees only the matching workers within their own Locations, groups, racks, and Customers, so Filtered Results can differ between users.

Operators

  • Status and list fields use Is with one or more values.
  • Numeric fields use Equals, Equals or More, Equals or Less, More Than, Less Than, or In Between. More Than and Less Than exclude the entered value.
  • Numeric conditions compare the exact stored value, not the rounded value shown in the table.
  • A worker with no value for a field never matches a condition on that field.

Available Fields

GroupFieldsValue
Status and fleetThe 14 Quick filter categoriesOne or more values
TemperatureMax Chip Temp, Inlet Temp, Outlet Temp, Target Temp, Hot Temp, Dangerous Temp℃, one decimal, below zero allowed
OutputCurrent Hashrate, Sticker HashrateTH/s
Current Power, Default PowerW
Est. EfficiencyJ/TH
TargetW or TH/s, select the unit
UptimeHashing Uptime, System Uptime% over the last 24 hours
Last SeenLast SeenBefore or After a date and time, or Older Than an age in hours or days
NetworkIP rangeFour octets, see below
Fans and coolingFans SpeedsRPM or %. A worker matches if any of its fans matches
Fan Speed RangeMin and Max. Matches when the configured range overlaps
Fan ModeManual or Automatic
Min Fans, Fan PWM, Fan RuntimeNumber, Braiins OS only
Device statePerf. ModeNormal, Low, High, Sleep
DPS StateEnabled or Disabled, Braiins OS only
HBs StateAll Working, or 1 to 4 hashboards stopped
FW Version, Control Board Type, Pool URL, Pool UsernameValues from your fleet. Pool fields match the active pool

Notes on specific fields:

  • Hashrate and efficiency conditions convert every worker to TH/s and J/TH before comparing, including workers shown in GH/s or J/GH.
  • Last Seen dates use the timezone of your account. Older Than is measured from the current time, so a saved "Older Than 1 day" filter returns different workers as time passes.
  • In an IP range, each octet takes a number, a span such as 5-20, or * for any value. One row holds up to 5 ranges of up to 65,536 addresses each. IPv4 only.
  • A Fans Speeds condition in % returns Braiins OS workers only, because stock firmware reports fan speed in RPM.

Edit, Duplicate, or Delete a Saved Filter

Hover a row in the Saved tab to see the actions you are allowed to use.

ActionWho can use it
EditThe owner, or a Provider Admin for any Location or Company filter of the organization
DuplicateAnyone who sees the filter. The copy opens in the Filter Builder as "(copy)" with Personal scope, and you own it
DeleteThe owner, or a Provider Admin for any Location or Company filter of the organization

Deleting a filter removes only the filter definition, never any workers. Deleting or narrowing a shared filter removes it from other users' Saved tabs, and Braiins Manager warns you before it does.

Select Workers

Select the workers you want to act on:

  • Click the checkbox on a row, select every worker on the current page, or select every worker that matches your filters.
  • Shift+click selects the range between the last clicked row and this one, in the current sort and filter order.
  • Ctrl+click (Cmd+click on macOS) adds or removes one row without clearing the rest.
  • From the keyboard, Space toggles the focused row, Shift+Space or Shift+Up/Down extends the range, and Ctrl+Space (Cmd+Space) sets a new starting row.

The toolbar shows the selection count. If you cancel an action dialog, the selection stays. It clears after you submit an action successfully.

Bulk Actions

Select one or more workers, then open the Actions menu. Actions are grouped as follows.

Administrative Actions

These actions change records in Braiins Manager and send no command to the miner:

  • Set Maintenance Mode: pauses data collection while you service the miners. The status changes to Maintenance, connectivity to N/A, and the miner leaves its Sitemap slot. To take a miner out of maintenance mode, use the Worker Details page.
  • Change Location
  • Change Customer
  • Change Device Model
  • Change Firmware
  • Set Custom Password
  • Remove: removed workers disappear from the list, summary, and exports, and Braiins Manager stops collecting their data.

Miner Actions

  • Pause Mining: select Mark as curtailed to have the miners resume automatically when the current curtailment event ends.
  • Resume Mining
  • Start BOSminer, Stop BOSminer, Restart BOSminer (Braiins OS)
  • Configure Pools
  • Advanced Settings (Braiins OS, Agent 4.12.0 or newer): change Braiins OS advanced settings. Click Check Compatibility to see which miners support your changes before you apply them.

System Actions

  • Reboot Device
  • Locate Device: flashes the miner LED so you can find it in the facility.

Performance Actions

Firmware Actions

  • Install Braiins OS: available for Antminer models that do not already run Braiins OS, except the D and L series.
  • Upgrade Braiins OS
  • Apply License
  • Restore Stock Firmware

Cooling and Temperature

Cooling and Temperature has its own button in the selection toolbar. Use it to set the cooling mode, fan settings, and temperature thresholds of Braiins OS miners. It requires Braiins OS 25.01 or newer. During an active curtailment, Braiins Manager asks you to resume mining with the curtailment bypass first.

A disabled action shows why it is unavailable. Commands are unavailable when the Agent is offline, the firmware does not support the command, the Braiins OS version is below the minimum for that command, or the miner is under an active curtailment. In maintenance mode, only Administrative actions are available. Mining commands can take up to 5 minutes to reach the miners.

Export to CSV

Click the export button (5) to download the Workers list as a CSV file named workers_export_<date>.csv.

  • Workers: export all workers, or only the workers that match your filters.
  • Columns: export the visible columns, all columns, or a custom set.
  • You can run up to 5 exports per minute.
  • Customer exports leave out the Customer, Location, Rack, Group, license, and Advanced Settings columns.

Was this helpful?