Installing the Agent on Linux

Agent Preparation in the Cloud

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

1. Log in to the HashCore Pulse control panel.
2. In the left menu, select Agents and click + New Agent.
3. Enter an agent name (e.g., Main_Site) and click Create.
4. In the window 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 name of the created agent and click + New Task to configure scanning:

• Task name: the name of the task (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 are using custom firmware (Vnish, Bitmain, etc.), specifying passwords for ASIC access (e.g., admin or root).

7. Click Create. The cloud is ready to go!

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 into this folder and unpack it.
3. Navigate to the folder with the unpacked files: cd ~/Pulse/<unpacked_folder_name>
4. Run the installer (administrator privileges are 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 a browser.

1. Operation via browser:

• Open a browser on the same computer/server and go 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 lower right corner of the screen). Clicking on it will open the management menu. The appearance of the menu and the color of the icon depend on the current state of the program:

Green icon (Pulse Agent: Running)

This means the agent is active and scanning the network. When clicked, the following options are available:

• Stop Service — completely stop the agent's operation.
• Restart Service — quick restart of the program (needed if you have changed settings).
• Dashboard & Settings — navigate to http://localhost:4030 in the browser 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. When clicked, the following options are available:

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

3. Local Statistics: After entering the keys, the page will refresh, and you will see detailed data about the agent's operation:

• Credentials — here you can link another 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 (enabled — on, disabled — off).
• connection_status — connection to the cloud (statuses: connected, initializing, domainNotAvailable, notAuthorized, internalError). For operation, the status must be connected.
• agent_id — unique agent ID with which the connection is currently established.
• worker_threads — number of parallel scanning threads.
• total — total number of IP addresses currently being checked.
• found_miners — number of found miners, separated by firmware types (vnish, bitmain, and whats).
• last_metric_submit — data on the last submission to the cloud:
  • elapsed_secs — how many seconds have passed since the last submission.
  • metrics_count — number of metrics submitted.
• ip_ranges — IP address ranges that the agent received from the cloud for scanning.

Verification and Management

Let's ensure that information from your devices is successfully reaching the server.

1. Go to pulse.hashcore.com.
2. Open the Dashboard section: hashrate graphs and the device counter (Workers) should display up-to-date data.
3. Go to the Workers section: a list of all found miners will appear here. Detailed information will be available for each device: IP address, hashrate, temperature, power consumption, fan operation, and firmware version.

Technical Maintenance and Management (Command Reference)

To manage the agent in Linux, use the following commands in the terminal: