This guide applies to server administrators, IT professionals, and technically inclined individuals who use Linux servers.
📘Instructions
Prerequisites:
Download and extract the latest hive-agent for Linux from hivenet.com.
Benefits of hive-agent as a systemd service:
Persistence: Continues running after reboots or logouts.
Management: Easy to manage and monitor with systemd.
Security: Isolates the process, enhancing server security.
1. Installation of hive-agent:
Move the extracted hive-agent binary to
/usr/local/bin:
sudo cp hive-agent /usr/local/bin/hive-agent
Set the appropriate permissions:
sudo chmod 755 /usr/local/bin/hive-agent
Verify the installation:
hive-agent version
2. Setting up a User Account for hive-agent:
Switch to the hive-agent-user account:
sudo su - hive-agent-user
Set up the configuration file:
Create the
.hivedirectory:
mkdir ~/.hive
Generate the default configuration file:
/usr/local/bin/hive-agent config init
(Optional) Modify the
config.yamlfile for custom configurations.
3. Authenticate with your hiveNet account:
Run the hive-agent contribute command (start with 5 GB or more):
/usr/local/bin/hive-agent contribute 5
Complete the authentication process using the provided URL in a web browser.
Exit the hive-agent-user session:
exit
4. Setting up hive-agent as a systemd Service:
Create a systemd service file:
sudo nano /etc/systemd/system/hive-agent.service
Add the following configuration, replacing
XXwith the GB to contribute:
[Unit]
Description=Hive Agent Service
After=network.target
[Service]
Type=simple
User=hive-agent-user
ExecStart=/usr/local/bin/hive-agent contribute XX
[Install]
WantedBy=default.target
Reload systemd:
sudo systemctl daemon-reload
Start the hive-agent service:
sudo systemctl start hive-agent
Enable the service to start on boot:
sudo systemctl enable hive-agent
Check the service status:
sudo systemctl status hive-agent
Stopping and removing the hive-agent service:
1. To stop the service:
sudo systemctl stop hive-agent
sudo systemctl disable hive-agent
2. To remove the service and hive-agent:
Remove the systemd service file:
sudo rm /etc/systemd/system/hive-agent.service
Reload systemd:
sudo systemctl daemon-reload
Remove the hive-agent binary:
sudo rm /usr/local/bin/hive-agent
(Optional) Remove the hive-agent-user and its directory:
sudo userdel -r hive-agent-user
(Optional) Remove the
.hivedirectory:
rm -rf ~/.hive
By following these steps, you can effectively contribute your server's unused resources to the hive network, ensuring optimal utilization and performance.