What's new#

 26.06

This release adds the ability to configure Braiins OS advanced settings from both the CLI and GUI.

CLI

• Configure BOS Advanced Settings: A new advanced command lets you manage Braiins OS advanced settings in batch — list available options (braiins-toolbox advanced list), read current values (braiins-toolbox advanced get), apply changes (braiins-toolbox advanced set), and restore defaults (braiins-toolbox advanced reset). Target every option with --all or specific options with -S <option>.

GUI

• Configure BOS Advanced Settings: A new menu action opens a modal where you can configure all available Braiins OS advanced settings.
• Single-Tab Operation: Toolbox can no longer be opened in multiple browser tabs at the same time. This was previously possible as an unintended by-product of the underlying tech stack; restricting it simplifies the software architecture. This decision may change in the future.

 26.05

This release brings several miner management improvements for a better overall user experience.

CLI

• Per-IP Result Output: The new --print-results option prints results broken out per device IP after batch operations, making it easier to see which miners succeeded or failed. Use --result-format (table or csv) to choose the output format and --result-file to save results to a file.

CLI & GUI

• Safer Antminer Configuration Changes: Improved reliability when applying pool, work mode, frequency level, and fan settings, preventing miners from ending up in an inconsistent state.
• Reliable BOS Cooling Configuration: Resolved cases where cooling settings on Braiins OS were saved but not applied.
• Clearer Invalid Credentials Handling: When an Antminer or Braiins OS device rejects the credentials in use, Toolbox now reports a distinct "invalid credentials" error instead of a generic failure.
• Improved Miner Detection: More accurate Antminer variant detection during scans, reducing "unknown variant" results.
• Clearer Compatibility Messages: Messages shown when a miner is unsupported or ineligible for an operation have been reworked across the CLI and GUI.
• Improved Antminer Communication Reliability: Resolved several edge cases in parsing Antminer responses for more dependable communication.
• Whatsminer Data Accuracy: Fixed handling of negative chip voltage difference values reported by Whatsminer devices.

 26.03

This release introduces GUI-based temperature management for Braiins OS, improves IceRiver data handling, and enhances boot reliability on Cvitek (Antminer) control boards.

GUI

• Temperature Control for BOS: Toolbox now supports comprehensive temperature management via GUI mode, allowing configuration of cooling mode, temperature settings, and fan settings.

CLI & GUI

• Improved IceRiver Data Parsing: Enhanced parsing of IceRiver miner data for more accurate reporting and better overall compatibility.
• Improved Booting on Antminers (CV1835): Increased boot reliability on Antminers equipped with the CV1835 control board.

 26.02

This release focuses on improved firmware compatibility, faster and more reliable Braiins OS installations, and broader support for the latest Antminer hardware.

CLI & GUI

• Introduced beta support for the Antminer S23 series running stock firmware.
• Optimized Braiins OS installation process to make Braiins OS deployments faster and reduce the overall failure rate.
• Fixed communication issues with Antminers on stock firmware version from September 2025 and newer.
• Updated the Stratum V2 configuration to support a Stratum V2 pool URL using the new secp256k1 authorization public key.
• Improved device communication across multiple vendors: Whatsminers (fixed communication issues affecting M6X models), Avalons (improved data parsing) and Antminers (general communication stability improvements).

CLI

• Added a new --fan-pause-runtimeoption to the braiins-toolbox cooling set command, allowing configuration of fan behavior on Braiins OS when a miner is paused. This option is supported on Braiins OS versions 26.01 and newer.

 25.10

Braiins Toolbox Release 25.10 brings expanded temperature configuration options, detailed hardware information, and more.

CLI

• Temperature Control for BOS: Toolbox now supports comprehensive temperature management via CLI mode, allowing configuration of cooling mode, temperature settings, and fan settings.

GUI

• Temperature Attributes in Device List (BOS): The GUI now displays BOS temperature-related information, including cooling mode, temperature, and fan attributes for each device.

• Hardware Attributes in Device List (BOS): Toolbox now shows additional hardware details such as Control Board (CB), Hash Board (HB), and Power Supply Unit (PSU) attributes directly in the Device List.

CLI & GUI

• Whatsminer API V3 (Beta): Toolbox adds beta support for the new Whatsminer API V3, expanding compatibility with the latest miner firmware.
• Optimized Miner Detection: Enhanced miner discovery for faster and more accurate detection across mixed environments.
• General Bug Fixes and Optimizations: Various stability and performance improvements across both CLI and GUI.
• Firmware Restore Scope Update: The command for restoring stock firmware now supports uninstallation of Braiins OS only.

 25.03.2

Braiins Toolbox 25.03.2 is a bugfix release that includes optimized logic for upgrading to Braiins OS, helping to minimize "No space left on device" errors.

 25.03.1

Braiins Toolbox 25.03.1 is a bugfix release improving compatibility with Antminer stock firmware and Iceriver miners.

CLI & GUI

• Antminer Stock Firmware Compatibility Fix: Resolved an issue that prevented reading and configuring pool settings on Antminers running stock firmware versions from 2025 and newer.
• Iceriver Attribute Reading Fix: Fixed incorrect or missing readings of several device attributes reported by Iceriver miners.

 25.03

Braiins Toolbox Release 25.03 introduces support for Avalon miners, a new DPS mode option, and more.

CLI & GUI

• Avalon Miner Detection and Control (Beta): Toolbox now offers beta support Avalon miners. In addition, you can manage these devices with actions such as pause, resume, reboot, and change pool settings.
• Support for DPS Boost Mode: Toolbox now supports the new DPS boost mode introduced in Braiins OS version 25.01. Learn more about this power mode enhancement in the Braiins OS release notes for 25.01.
• Extended Pool Username Variables: The pool username variables now include {{miner.ip_x}}, representing the miner's IP address with a custom "x" separator instead of a dot.
• BOS Upgrade Disk Space Issue: Resolved an issue where BOS upgrades could fail due to insufficient disk space on miners.

GUI

• Enhanced CSV Export: The CSV export functionality now respects filtering, sorting, column visibility, and order. Note: Only static data can be exported.
• GUI Target Column Sorting: Fixed the incorrect sorting of the Target column.

 24.12.1

Braiins Toolbox Release 24.12.1 is a bugfix release that addresses issues with sorting and custom password removal.

GUI

• User can now remove custom password via GUI
• Fix a bug in sorting by pools configuration

CLI

• Fix a wording while using --all-devices flag during scan

 24.12

Braiins Toolbox Release 24.12 introduces new features and improvements.

CLI & GUI

• Users can now view all discovered devices, including unrecognized and password-protected ones, providing a comprehensive overview for improved farm management

• Added basic support for Iceriver miners, including detection, pause/resume mining, pool configuration, and reboot functionality

• Resolved an issue where the immersion configuration was not functioning correctly during advanced installation

• Optimized Braiins OS upgrades to prevent failures caused by full disk space on the miner

GUI

• Users can now control Toolbox entirely via keyboard shortcuts, enabling miner selection, quick access to all actions and configurations, and simplified navigation without the need for a mouse or touchpad
• Braiins OS updates now correctly display the list of supported platforms for each release in the "Braiins OS Updates" tab

 24.09

Braiins Toolbox Release 24.09 introduces new features and improvements.

CLI & GUI

• Hashrate target tuner mode is now fully supported, allowing for batch hashrate target setting on Braiins OS devices, during Braiins OS installation, and Dynamic Power Scaling (DPS) configuration

GUI

• New data fields such as sticker hashrate, power target and license name added to the device list. Sorting and filtering options expanded
• View the latest Braiins OS versions directly in the new "Braiins OS Updates" tab
• Added link to Braiins Toolbox Academy documentation

 24.07.1

Braiins Toolbox Release 24.07.1 is a bugfix release that addresses issues with upgrading Braiins OS on the Braiins Control Board BCB100.

 24.07

Braiins Toolbox Release 24.07 introduces new features and improvements.

CLI & GUI

• IP ranges can now be defined using CIDR notation

GUI

• Significant performance improvements have been made to support large mining sites

• Fixed the issue of an empty device list appearing after running for a long time

CLI

• Hashrate target can now be configured in batch on Braiins OS devices
• Hashrate target and DPS can now be configured in batch during Braiins OS installation
• Fixed the issue where the confirmation prompt message was not being bypassed in CLI commands

 24.06

Braiins Toolbox Release 24.06 introduces new features and improvements.

CLI & GUI

• Fixed configuration issue for pools when no pool group is defined

GUI

• IP ranges for the scanner can now be uploaded as a list of IP addresses in a CSV file
• Continuous refresh of the Device List can now be disabled by the user
• Performance filter for the Device List now includes an N/A option
• Corrected active Device List filters when Toolbox is restarted
• Resolved automatic booting of Braiins OS on Cvitek control boards after device reboot
• Fixed misleading 0 0 0 0 fan RPM display for hydro machines

 24.05

This update introduces new features and improvements for better device management and system performance.

CLI & GUI

• Users can now discover devices with LuxOS firmware and restore them to stock firmware using both CLI and GUI

CLI

• The system collect-data command no longer generates invalid empty .tar.gz files

GUI

• Specifying multiple labels in the device list filters will now find all devices matching at least one label, instead of requiring all labels to match
• Fixed slow configuration saving for multiple IP ranges
• Enhanced performance during compatibility checks before installing Braiins OS
• Improved the Pool URLs column design on the device list to enhance readability

 24.04

Braiins Toolbox Release 24.04 introduces new features for both GUI and CLI, along with several improvements to enhance system stability and performance.

CLI & GUI

• Custom Contract Codes - Users can now easily apply their custom contract codes both during and after the installation of Braiins OS in GUI and CLI

• Public IP Filtering - Automatically exclude all public IPs from defined ranges to enhance security and scanning speed

See Firmware CLI documentation for CLI usage.

CLI

• Bypass Confirmation Dialog - New -y or --yes flag allows users to bypass confirmation dialogs, facilitating smoother operations for scripting

GUI

• Enhanced Installation - Configure Braiins OS during the initial setup to start mining immediately. This includes selecting the specific release, applying custom contract codes, configuring the pool, and adjusting power and cooling settings
• Disabling IP Ranges - Temporarily disable specific IP ranges without deleting them

 24.03

Braiins Toolbox 24.03 introduces several enhancements, including an expanded device list, improved pool settings, installation of the Braiins OS target version, and support for the Antminer S21 series. Additionally, it offers network configuration capabilities for the miners, along with various performance and stability improvements.

CLI & GUI

• Support for Antminer S21, including detection and Braiins OS installation

• Installation of the target version of Braiins OS to provide enhanced control over the installation process

• Pool presets allow for defining desired pools and using them during installation and pool configuration

CLI

• Configuration of dynamic or static network settings on the selected miners in batch

GUI

• Extensive device list with details like current hashrate, uptime, and maximum temperature, alongside enhanced full-text search and filtering features

 24.02

New Braiins Toolbox release featuring automatic device list update, support for Whatsminer devices, workername templating in the GUI, tuner profile removal in GUI, Braiins OS installation eligibility checks and more.

CLI & GUI

• Support of the Whatsminers on a stock firmware (pause, resume, pool configuration, reboot, locate device)

• Hardware compatibility checks before initiating Braiins OS installation to prevent installation on unsupported hardware

CLI

• Set power limit for Whatsminers on stock firmware

GUI

• Automatic refresh of the device list to ensure it stays up-to-date
• Empower toolbox GUI users with the ability to incorporate username variables when configuring pool usernames
• Efficiently clean tuned profiles for miners operating on Braiins OS via Toolbox GUI

 23.12

New Braiins Toolbox with enhanced support for remote installation on new Antminer control boards, advanced installation features, and more.

CLI & GUI

• Remote installation of Braiins OS on miners with Cvitek (CV1835) or Zynq control boards

• Addressed the issue of DPS configuration failures occurring when immersion mode is enabled

• Resolved the issue with detecting miners operating on Braiins OS 23.03

CLI

• Simplified configuration process for miners during remote installation of Braiins OS with a streamlined one-step multiconfiguration

• MAC address (miner.mac) username variable in pool configuration settings

• Restored proper CLI character display for the Windows build

GUI

• Mitigated various GUI issues

 23.11

New Braiins Toolbox release 23.11 packed with enhanced features, improved support for Bitmain Stock FW, new CLI capabilities, and various refinements.

CLI & GUI

• Configure pools for miners with Bitmain stock FW
• Adjust power modes for miners with Bitmain stock FW
• Reboot miners with Bitmain stock FW effortlessly
• Easily locate miners running Bitmain stock FW
• Implemented several graphical enhancements on both CLI and GUI interfaces

CLI

• Empower toolbox CLI users with the ability to incorporate username variables when configuring pool usernames

• Efficiently clean tuned profiles for miners operating on Braiins OS

GUI

• Resolved an issue with incorrect date display in the actions list in the GUI
• Addressed a naming discrepancy for command/script execution stdout files in the GUI

 23.10.3

Introducing the long-awaited Braiins Toolbox for Windows, featuring graphical fixes in the GUI.

CLI & GUI

• Braiins Toolbox for Windows

GUI

• GUI improvements

 23.10.2

Introducing Braiins Toolbox for macOS, compatible with Monterey 12.4 and newer, and featuring stability improvements.

CLI & GUI

• Braiins Toolbox for macOS
• Stability improvements

 23.10.1

Introducing Braiins OS remote installation on newly supported Antminer models, along with a one bug fix.

CLI & GUI

• Braiins Toolbox can now batch-install Braiins OS on the following newly supported Antminer models: S19j Pro+, S19k Pro, S19 Pro-A, and S19j Pro-A
• Fixed uninstallation command for improved functionality in specific cases

 23.10

This release brings exciting new features and enhancements that will make your farm management even more seamless and efficient.

CLI & GUI

• Braiins Toolbox can be now directly upgraded once a new version is out
• Linux commands execution in batch directly on miners
• Support for pause/resume actions for Bitmain stock firmware (Braiins OS is already supported)
• Full support for the Braiins control board
• Whatsminer detection
• Smoother Braiins OS installation
• Improvement of collected device info, ensuring it is efficiently compressed and encrypted

 23.08.1

This bug fix release addresses the issue where unsupported Antminer models were incorrectly displayed as Installable in the Toolbox.

CLI & GUI

• Unsupported Antminer models are not displayed as Installable and Braiins OS cannot be installed

 23.08

Introduction of the new miner, system and performance management features.

Toolbox 23.08 uses the newest version of Public API 1.0.0-beta.2 that contains several breaking changes (more info on GitHub).

CLI & GUI

• Mining pause (Braiins OS)
• Mining resume (Braiins OS)
• Locate the device(s) (Braiins OS)
• Collect device data
• Dynamic performance scaling configuration (Braiins OS)
• Cvitek and BCB100 controlboards detection

 23.05.1

Patch release resolving a power target related bug.

GUI

• Fix issues with the relative change of the power target in the GUI

 23.05

First version of the long-awaited GUI version. This new interface enhances the user experience and provides a more intuitive way to interact with our powerful command-line tool, while still retaining full functionality from the Linux terminal.

With the new GUI, you can now enjoy the benefits of a visually appealing and user-friendly interface, making it easier than ever to navigate and utilize the extensive capabilities of Braiins Toolbox. The GUI is designed to streamline your workflow and simplify complex operations, ensuring a seamless experience from start to finish.

GUI

• Network scan
• Braiins OS installation
• Braiins OS uninstallation
• Braiins OS upgrade
• Reboot of the system (Braiins OS)
• Power target configuration (Braiins OS)
• Pool settings configuration (Braiins OS)
• Miner actions: start/stop/restart (Braiins OS)
• Cooling mode configuration (Braiins OS)

 23.04.1

Patch release bringing small changes and bug fixes.

CLI

• Argument --scan-rate became a global argument
• Subcommand restore renamed to uninstall
• Argument --input renamed to --ip-file
• Braiins OS upgrade over major version(s)

 23.04

Introducing Braiins Toolbox: the groundbreaking software designed exclusively for efficient management of Bitcoin mining farms at scale. This highly anticipated release marks the software's debut, offering a command-line interface (CLI) and a specialized focus on batch management for Braiins OS firmware. Experience unparalleled control and optimization for your mining operations with Braiins Toolbox.

CLI

• Network scan
• Braiins OS installation
• Braiins OS uninstallation
• Braiins OS upgrade
• Reboot of the system (Braiins OS)
• Power target configuration (Braiins OS)
• Pool settings configuration (Braiins OS)
• Miner actions: start/stop/restart (Braiins OS)
• Cooling mode configuration (Braiins OS)