Contact Sales

Autoupgrade

Autoupgrade

The Autoupgrade feature is an opt-in miner management tool designed to keep your Braiins OS devices automatically updated. When enabled, it ensures your miners receive the latest firmware versions—including new features, performance enhancements, and bug fixes—with minimal manual intervention.

The Upgrade Process

The autoupgrade process is designed to be safe and minimally disruptive. When the miner reaches its scheduled time to check for an update (based on your Daily, Weekly, or Monthly setting), it follows these steps:

  1. Health Check: The system first verifies that the miner is "healthy." If the miner is not healthy, the process stops here and will be re-attempted at the next scheduled interval.
  2. Download: If the miner is healthy, it checks for a new firmware version. If an update is available, the miner downloads it in the background while continuing to hash.
  3. Install: Once the download is complete, the update is installed.
  4. Reboot: The miner automatically reboots to apply the changes.
  5. Resume Hashing: After the reboot, the miner resumes hashing with the new firmware.

What is a "Healthy" Miner?

The health check is a crucial safety measure to prevent updates on a device that might be unstable. For the autoupgrade feature, a miner is considered healthy if it has been online for at least one (1) hour and is currently hashing.

This check ensures the update is not applied to a miner that is crashing, frequently rebooting, or otherwise malfunctioning, which could complicate the upgrade process.

Understanding the Update Schedule

To prevent all your miners from upgrading simultaneously (which could cause a sudden, temporary drop in your total hashrate), the update schedule uses a randomized approach.

When you enable autoupgrade, you choose a frequency:

  • Daily: The miner will pick a random time within the next 24 hours to check for an update.
  • Weekly: The miner will pick a random time within the next 7 days to check.
  • Monthly: The miner will pick a random time within the next 28 days to check.

Example: Weekly Schedule

Let's say you enable the "Weekly" autoupgrade on a Monday.

  • The miner immediately picks a random time within the next 7 days (e.g., Thursday at 4:30 AM).
  • The miner does nothing until that time arrives (Thursday at 4:30 AM).
  • At that exact time, it begins the autoupgrade process:
    • If the miner is not healthy, the process stops.
    • If the miner is healthy, it then checks for a new update.
    • If an update is available, it will proceed with the Download, Install, and Reboot.
  • The next check is then scheduled for exactly 7 days later (the following Thursday at 4:30 AM).

This "sticky" random time ensures that each miner in your fleet checks for updates at a different, staggered time, providing stability for your overall operation.

Large deployments

As each miner will check the availability of an update individually, it can be taxing on network infrastructure to have thousand miners downloading a new firmware. Alternatively Braiins Toolbox can download the required firmware once and push the update to the miners using your local network.

Was this helpful?