Skip to main content
This guide walks you through the complete setup flow — from creating your account to watching live hashrate data roll in.
1

Create your Dune Digital account

Go to dunedigital.xyz and sign up. After confirming your email you will land on the onboarding screen.
2

Complete onboarding

Choose your operating intent on the onboarding screen. Select Hash Streams (fleet operations) if you are running your own miners or hosting customers. This determines which modules are enabled in your account.
You can change your intent later from Settings → Organization. If you also host customers, enable the Hosting add-on on the Business plan.
3

Create a site

Navigate to Setup → Sites and click Add Site, or launch the guided Setup Wizard from the Setup landing page.Fill in the site form:
FieldDescription
Site NameA human-readable label, e.g. Texas Facility
CityUsed for weather data lookups
State / CountryDisplayed to customers on invoices and dashboards
TimezoneControls how timestamps and daily summaries are displayed
Capacity (kW)Total power available at the site, e.g. 5000
Energy Cost ($/kWh)Your power rate, e.g. 0.05. Leave blank to use the org-level default
Click Continue (or Save) to create the site.
4

Add a network segment

Navigate to Setup → Networks and select the site you just created from the site picker.Add the subnet that your miners sit on, for example 192.168.1.0/24. The agent uses this CIDR to scope its discovery scan to the correct broadcast domain.
If your miners span multiple VLANs, add each subnet as a separate network segment on the same site.
5

Download and install the site agent

Navigate to Setup → Agents and click Add Agent. The dashboard generates a one-time 6-character registration code for your site.Copy the install command for your platform and run it on a machine inside the mining network (a management server, a Raspberry Pi, or any always-on Linux box on the same layer-2 segment as the miners).
curl -sSL https://get.hashstream.dev | sudo bash -s -- --code <REG_CODE>
Replace <REG_CODE> with the 6-character code shown in the dashboard. The installer handles downloading the agent binary, registering it with the platform, and starting it as a system service.
Registration codes expire. If yours expires before you run the command, click Regenerate Code in the Agents page to get a new one.
6

Verify agent connection

After the install command completes, return to Setup → Agents. Within a few seconds the agent’s status should change from Pending to Online.The agent authenticates using an encrypted token issued during bootstrap. You do not need to manage API keys manually — the installer handles this automatically.
If the agent stays Pending for more than two minutes, check that the machine has outbound HTTPS access and that the registration code has not expired.
7

Run a network scan

Navigate to Setup → Networks, select your site, and click Scan next to the network segment you added.The agent broadcasts to the subnet and probes common miner API ports (port 4028 for CGMiner/BMMiner-compatible firmware, and vendor-specific APIs for other manufacturers). Discovered miners are added to the equipment registry automatically.A typical scan of a /24 completes in under 60 seconds.
8

View miners in Mining Control

Navigate to Mining Control → Discovery (or Hash Streams → Discovery).You will see a live grid of all discovered miners with their status, hashrate, model, and IP address. Status badges refresh on a 50-second polling cycle.

Active

Miner is hashing within the expected freshness window.

Degraded

Miner is online but reporting a warning, throttled hashrate, or chip failure.

Offline

Miner is not responding on the network.

Stale

Data is older than the freshness window — agent may have lost connectivity.
Use the filter bar to narrow by status, network segment, firmware, PDU, or CDU.

​
What’s next

Onboard customers

Add hosted customers, create contracts, and send invoices.

Configure alerts

Set up event rules so you’re notified when equipment has problems.