Skip to main content
Nonce Agent runs on a host at the site and connects the farm’s miners to Nonce. Each farm has its own Agent.

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 sudo access, or Windows (Beta). To size the host, see Host requirements.
  • Network: the host needs outbound HTTPS access to agent.nonce.app and 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

  1. In Nonce, open the farm’s settings and select the Agent tab.
  2. Click Setup. Nonce creates the Agent and opens the Setup Agent dialog.
  3. Select Linux or Windows, then click the install command to copy it.
  4. Run the command on the host.
  5. 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.
If Nonce shows Agent not installed yet, wait for the command to finish, then click Confirm again.
The install command contains the Agent’s ID and key. Use it for this farm only.

Update the Agent

The Agent doesn’t update on its own.
  1. In the farm’s settings, open the Agent tab.
  2. Click Check for Updates. The dialog shows the change log of the available version.
  3. Click Update. The Agent downloads the new version, verifies it, and restarts.
If the dialog shows 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