Skip to main content
Fix an Agent that goes offline and miners that don’t appear in Nonce or stop updating. Start with the section that matches what you see: For when scans run and how long results take, see How Nonce Agent works.
The commands on this page apply to Agent 2.0.0 and later on Linux. To check the version, run nonce-agent version on the host. Installations that predate Agent 2.0.0 keep the configuration file at /etc/nonce-agent/.env.

No miners appear after a scan

Work through these checks in order. After each fix, start the scan again.

Check that the Agent is online

In the farm’s settings, open the Agent tab. The status dot is green when the Agent is online. If it isn’t, see The Agent is offline.

Check the scan task

Open the farm’s Tasks page and find the scan task:

Check the IP ranges

The IP ranges must include the subnet the miners are on. Look for these mistakes:
  • The subnet is wrong.
  • The range covers the management network instead of the miner network.
  • The miners moved to a different VLAN or subnet.

Check the Agent on the host

Run these commands on the Agent host:

Some miners are missing

When a scan finds part of the farm, check the missing miners’ passwords and model support. Then ask the Agent why it failed to read them.

Check miner passwords

If the missing miners use a non-default web password, set it on the Agent host. See Miners use a non-default password.

Check model and firmware support

Look up the miner in Supported miners and firmware. If the model or firmware isn’t on the list, the Agent may be unable to identify the miner or read its data.

Check one missing miner

Run this command on the Agent host with the address of a missing miner:
The output shows the miner’s record and its recent history, including the stage and reason of each failure.

A miner stopped updating

A miner’s record stops updating for one of these reasons:
  • The miner is unreachable.
  • Data collection for the miner fails repeatedly.
  • The miner is no longer inside the farm’s IP ranges.
To find the cause:
  1. Scan the farm again.
  2. Test the miner from the Agent host:
    If the command fails, check that the miner is reachable and that its password matches the Agent configuration.

The page shows old data after a scan

Nonce can finish processing scan data before the page you have open refreshes.
  1. Refresh the Miners page.
  2. Open the task and confirm that it completed.
  3. Wait for the next collection. For the interval, see What happens during a scan.

A deleted miner comes back

Deleting a miner removes its record and its rack position, but the Agent keeps collecting data from its address. If the miner is still online, it reappears on the Miners page after its next successful report, without a rack position. To keep a miner removed, take it off the network, or remove its address from the farm’s IP ranges and save them.
A deleted miner that stays offline doesn’t reappear until it reports again.

The Agent is offline

Run these steps on the Linux Agent host.
  1. Check the Agent service:
  2. Read the Agent logs:
  3. Confirm that the host can reach agent.nonce.app over HTTPS.
  4. Restart the service:
    In Nonce, the Agent’s status dot turns green when the Agent is back online.
On Windows, the Agent is offline whenever its window is closed. Open the Nonce Agent desktop shortcut to start it.

Recover after a power outage

On Linux, the Agent runs as a service that starts when the host boots. After power returns, start the host if it doesn’t start on its own. The Agent resumes collecting data when the operating system finishes booting.
On Windows, the Agent doesn’t start with the host. Open the Nonce Agent desktop shortcut to start it.

Miners use a non-default password

The Agent signs in to Antminer miners with the web password root and to WhatsMiner miners with admin. If you changed either password, set the new one on the Agent host:
  1. Open the Agent configuration file, ~/.nonce-agent-default/.env.
  2. Remove the # from the line for your miner brand and replace the value with the miner password:
  3. Save the file and restart the Agent:
    The Agent uses the new password after it restarts.
One password applies to every miner of that brand in the farm.

Get more help

Collect the Agent logs and contact Nonce support if:
  • The Agent stays offline after a restart.
  • The Agent is online but every scan task fails.
  • fetch-miner fails for miners that are reachable.
  • Scan tasks succeed but no miner data appears in Nonce.
  • One miner brand fails every time while other brands work in the same subnet.