Contact Sales

Braiins Manager Agent Overview

Overview

The Braiins Manager Agent is a crucial part of the system, serving as the communication link between your mining hardware and the Braiins Manager backend. The agent runs locally, offering real-time monitoring, control, and automation for your miners.

In April 2025, Braiins introduced a new generation of the Agent (version 4.0.0), written in Rust. This version replaces the legacy Node.js-based Agent (3.x.y), offering improved performance, stability, simple installation, and native Agent GUI support.

Download Braiins Manager Agent v4.0.0+ and view changelog at: https://downloads.braiins.com/braiins-manager-agent/

Key Features

  • Data Collection: Periodically collects important statistics data from all miners for monitoring and reporting purposes.
  • Miner Management: Enables bulk management of miners, including actions such as rebooting, changing pool configurations, and pausing or resuming mining activities.
  • Single Location Support: Each agent is associated with one location within Braiins Manager.

Location and Agent Setup

Before installing the agent, you must create a Location in Braiins Manager. Once the location is created, a unique Agent ID is generated for that location. This ID is used to link the agent during installation.

Setup Steps

  1. Create a Location: Go to the Locations section to create a new location.
  2. Obtain Agent ID and Secret Key: After the location is created, you'll receive the Agent ID and Secret Key. Agent ID and Secret Key are used in Braiins Manager installation to securely authenticate and link the mining device to your Braiins account for remote management.
  3. Install the Agent: Use the Agent ID and Secret Key during installation to configure the agent for the location. For server prerequisites, refer to Prerequisites page. Linux is preferred for running agent, see Linux installation guide. In case you prefer Windows, see Windows installation guide.

Status Monitoring

Once installed, monitor the agent's status in the Locations menu. If the Last Online time is less than 5 minutes, the agent is operating correctly. If it exceeds 5 minutes, there may be a connectivity issue.

Running Multiple Agents

While you can technically run multiple agents on a single server, we recommend running one agent per server to avoid server overload and ensure stable performance.

Was this helpful?