Agent Installation on Linux

Agent Preparation in the Cloud

At this step, we will create an agent profile and set parameters for discovering miners on your network.

1. Log in to the HashCore Pulse dashboard.
2. In the left menu, select Agents and click + New Agent.
3. Enter the agent name (e.g., Main_Site) and click Create.
4. In the dialog that appears, click the Linux X64 button to download the installation archive.
5. Be sure to copy and save the Agent ID and Agent Secret (if you closed the window, you can find them by clicking the three dots next to the agent → Show Credentials).
6. Click on the created agent's name and press + New Task to configure scanning:

• Task name: task name (e.g., Main Network Scan).
• IP Range: click + Add IP range and specify your network range (e.g., 192.168.0.0 - 192.168.0.255).
• Unlock Configs: fill in this tab if you use custom firmware (Vnish, Bitmain, etc.) by specifying passwords for ASIC access (e.g., admin or root).

7. Click Create. The cloud is ready!

Installing the Agent on Linux

Now let's transfer the downloaded file to the working environment and install it.

1. Open the terminal and create a folder for the agent: mkdir ~/Pulse
2. Place the downloaded archive in this folder and extract it.
3. Navigate to the extracted files folder: cd ~/Pulse/<extracted_folder_name>
4. Run the installer (administrator rights required): sudo ./pulse-agent-updater
5. Enter your account password, confirm the installation by typing y, and press Enter. Wait for the process to complete.

Agent Management and Local Statistics

In Linux, the system tray is not always available (it exists in GNOME/KDE but not in XFCE). Therefore, the agent is managed via the browser.

1. Operation via Browser

• Open the browser on the same computer/server and navigate to: http://localhost:4030 (or http://127.0.0.1:4030).
• Paste the Agent ID and Secret key (which you copied in the first step) into the corresponding fields.
• Click the Submit button.

2. Management via System Tray

When Pulse Agent is running, its icon appears in the system tray (in the bottom-right corner of the screen). Clicking it opens the management menu. The menu appearance and icon color depend on the current program state:

Green Icon (Pulse Agent: Running)

This means the agent is active and scanning the network. Clicking provides access to:

• Stop Service — completely stop the agent.
• Restart Service — quickly restart the program (needed if you changed settings).
• Dashboard & Settings — open the browser at http://localhost:4030 to view settings or logs.
• About — view program version information.

Gray Icon (Pulse Agent Service: Stopped)

This means the program is running but miner discovery is stopped. Clicking provides access to:

• Start Service — start the scanning and data transmission process to the cloud.
• Dashboard & Settings — open the browser at http://localhost:4030 to view settings or logs.
• About — view program version information.

3. Local Statistics

After entering the keys, the page will refresh and you'll see detailed data about the agent's operation:

• Credentials — here you can bind a different agent by changing the Agent ID and Secret key.
• uptime — continuous program uptime (in seconds).
• time — current date and time.
• version — installed Pulse Agent version.
• monitor_status — monitoring status (on — on, off — off).
• connection_status — cloud connection (statuses: connected, initializing, domainNotAvailable, notAuthorized, internalError). For operation, the status must be connected.
• agent_id — unique ID of the agent currently connected.
• worker_threads — number of parallel scanning threads.
• total — total number of IP addresses currently being checked.
• found_miners — number of found miners, broken down by firmware types (vnish, bitmain, and whats).
• last_metric_submit — data about the last submission to the cloud:
  • elapsed_secs — seconds since the last submission.
  • metrics_count — number of submitted metrics.
• ip_ranges — IP address ranges the agent received from the cloud for scanning.

Verification and Management

Let's make sure information from your devices is successfully reaching the server.

1. Go to pulse.hashcore.com.
2. Open the Dashboard section: hashrate charts and device counter (Workers) should display current data.
3. Go to the Workers section: a list of all discovered miners will appear here. For each device, detailed information is available: IP address, hashrate, temperature, power consumption, fan operation, and firmware version.