Before you begin
- Role: installing and updating an Agent requires the Admin or Manager role.
- Host: a 64-bit x86 (x86_64) host running Linux with systemd and root or
sudoaccess, or Windows (Beta). To size the host, see Host requirements. - Network: the host needs outbound HTTPS access to
agent.nonce.appand a stable connection to every miner on TCP ports 80, 443, and 4028.
Windows support is in beta. On Windows, run the install command in PowerShell or Command Prompt. The Windows Agent differs from the Linux Agent in three ways:
- Window: the Agent runs in its own window. Keep the window open. To start the Agent again, open the Nonce Agent desktop shortcut.
- Startup: the Agent doesn’t start when the host boots.
- Updates: the Agent can’t be updated from Nonce.
Install the Agent
- In Nonce, open the farm’s settings and select the Agent tab.
- Click Setup. Nonce creates the Agent and opens the Setup Agent dialog.
- Select Linux or Windows, then click the install command to copy it.
- Run the command on the host.
- In the dialog, click Confirm. Nonce shows
Agent installed successfully, and the Agent tab shows the Agent’s ID, version, and uptime next to a green status dot.
Agent not installed yet, wait for the command to finish, then click Confirm again.
Update the Agent
The Agent doesn’t update on its own.- In the farm’s settings, open the Agent tab.
- Click Check for Updates. The dialog shows the change log of the available version.
- Click Update. The Agent downloads the new version, verifies it, and restarts.
There are currently no updates available., the Agent is on the latest version.
Host requirements
For the hardware, choose the row that matches the number of miners the Agent manages. The figures assume a 5-minute collection interval.
- Storage: use an SSD. The storage figures assume one, because the Agent writes miner data and logs and caches firmware packages.
- Headroom: add capacity when the host runs network scans and firmware updates at the same time, or runs several Agent instances.
- Network: Gigabit Ethernet is recommended.
What the installer sets up
On Linux, the installer registers the Agent as a systemd service and creates a directory for its files:~ is the home directory of the user that ran the install command.
Next steps
- Scan for miners: add the farm’s IP ranges and run the first scan
- How Nonce Agent works: when scans run and how often the Agent collects data
- Troubleshoot Nonce Agent: fix an offline Agent, missing miners, and non-default miner passwords