Skip to main content

How to install and activate the Miner Agent

Learn how to download, install and activate the Miner Agent on Windows and Linux, and run your first network scan

The Miner Agent is the local EMCD Monitoring agent for monitoring ASIC miners at the farm. It is installed on a dedicated device on the same network as your mining hardware, and it is the only component you have to configure on site (Sec. 1, Cl. 4.3, 11.1 Monitoring Product Terms)..

How to download the agent

  1. Go to the Scanner section and click the agent download button.
    ​

    The "Scanner" section — the agent download button

  2. Select the platform and the site the agent is being installed for.
    ​

Installing the agent on Windows

  1. Unpack the downloaded archive.

    Contents of the Windows agent archive

  2. Start the agent with the command shown in the terminal (Sec. 1, Cl. 11.3 Monitoring Product Terms).
    ​

    The agent start command

Installing the agent on Linux

Installation instructions are available right in the interface — follow the steps on screen (Sec. 1, Cl. 4.3, 4.4, 11.3 Monitoring Product Terms).
​

Linux installation instructions

The agent installs as a system service (systemd) and starts automatically. Root privileges are required for installation and startup.

How to activate the agent

Once the commands have run, go back to the interface and click Activate agent (Cl. 2.2, 3.1, 4.3 Monitoring Product Terms).

The agent activation button

If needed, an additional agent can be downloaded for the same site.

Downloading an additional agent

The system is not meant to run several agents for one site — only one agent can be active at a time (Cl. 4.3, 9.1, 11.3 Monitoring Product Terms)..

How to run a network scan

The agent scans the local network of the machine it is installed on. From the agent card you can start or restart the agent, or start a scan (Cl. 4.3, 9.1, 11.3 Monitoring Product Terms)..

Agent management — restart and scan

After the scan, a list of the discovered devices appears. Serial numbers can be entered right away or later, on the unconfirmed devices tab.

Scan results — the discovered devices

Devices awaiting serial number confirmation are shown in the Devices section (Sec. 1, Cl. 11.1 Monitoring Product Terms).

Unconfirmed devices in the "Devices" section

How the agent works

  • Scanning happens in the local network of the machine where the agent is installed.

  • It reaches ASIC devices over HTTP/HTTPS on ports 80/443.

  • Telemetry is sent to the cloud over gRPC on port 443 (TLS).

  • It runs as a system service (systemd) and starts automatically.

  • Device discovery uses ICMP plus an HTTP probe (Sec. 1, Cl. 11.1, 11.2, 11.3, 11.5, 11.6 Monitoring Product Terms).

Once your devices are added, you can assign owners to them or move on to viewing metrics.

When using EMCD Monitoring, the local agent (Miner Agent) is installed with root privileges. It scans devices and transmits technical metrics to the cloud in accordance with our privacy policy. By starting the scan, you confirm that you are scanning only your own network and equipment (Cl. 2.2, 9.1, 10.1, 10.3, 11.1, 11.2, 11.3, 12.1, 13. Monitoring Product Terms).

Your use of EMCD Monitoring is governed by the Monitoring Product Terms (Cl. 18.1 Monitoring Product Terms).

Did this answer your question?