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.

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.
Search
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:
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.
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.

- In the filter panel, click Filter Builder.
- Enter a Filter Name of 3 to 100 characters. A name that already exists shows a warning but does not block saving.
- 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.
- In the first condition row, select a field, an operator, and a value.
- Click + Add Filter to add more rows. Rows are joined with AND. Several values in one row are joined with OR.
- Check Filtered Results, which shows how many workers match the conditions right now.
- 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
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.
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
- Set Performance and DPS: see Performance Settings.
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.