Before you begin
- Account: a Nonce account that can sign in at nonce.app.
- Host: a Linux or Windows (Beta) computer at the site that can reach the miners over the network. See Before you begin on the Agent installation page.
- IP ranges: the IP ranges of the network the miners are on.
Step 1: Create a workspace
A workspace holds the farms, miners, Agents, and members of one organization.- Sign in at nonce.app. Nonce lists the workspaces you can access.
- Click Create workspace.
- Enter a name for the workspace and complete the form. Nonce opens the workspace home, which shows the Let’s build your farm checklist.
Step 2: Create a farm
A farm groups the miners at one site.- In the checklist, click Create Farm. Nonce opens the farm setup on the Metadata tab.
- Enter the Name and the Electricity Fee in USD/kWh, and select the Location. Alias and Hosting Fee are optional.
- Click Save. Nonce creates the farm and opens its settings on the Miners tab, next to the Pools, Agent, and Scan tabs.
Creating a farm requires the Admin role.
Add miner inventory and pools
These two tabs are optional. Nonce marks them as recommended in the checklist, and you can fill them in at any time.- Miners: click Add Miner, then enter the model, hashrate, efficiency, and quantity. Nonce calculates the farm’s theoretical hashrate from this inventory.
- Pools: click Add Pool, then paste the pool’s observer link. Nonce compares the pool’s hashrate with the hashrate the Agent reports.
Add Pool is available after you add at least one miner model. Pool data can take up to 10 minutes to appear.
Step 3: Install the Agent
Nonce Agent runs on a host at the site. It discovers the miners, collects their data, and carries out the operations you start in Nonce.- Open the Agent tab and 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 a green status dot.
If your Antminer or WhatsMiner miners don’t use the default web password, set the password on the host before you scan. See Miners use a non-default password.
Step 4: Scan for miners
- Open the Scan tab and click Update.
-
Enter the IP ranges, one per line. Each line is a single address, a range, or a CIDR block:
- Click Save. Nonce dispatches a scan and opens a task dialog with the Queuing, Success, and Failed counts.
- When the dialog title changes to Task Completed, open the Miners page. The page lists the miners the Agent found.
To scan again without changing the IP ranges, click Scan Miners on the Scan tab, or in the More menu on the Miners page.
Step 5: Check the farm overview
Open the farm’s home page. When the first data arrives, the page shows the farm overview:- Hashrate History charts the hashrate the Agent reports.
- Miner Types counts the miners that are Online, Normal, Abnormal, and Offline.
- Recent Tasks and Recent Alerts list the latest activity in the farm.
Until the first data arrives, the farm’s home page shows the checklist with the hint
Miners found. Waiting for their first hashrate data.Next steps
- Invite members: give your team access to the workspace and its farms
- Operations: find miners, run batch operations, and automate with rules
- Roles and permissions: decide who can view, operate, and manage each farm
- How Nonce Agent works: when scans run and how often the Agent collects data