Getting Started

The ConHive Agent is a lightweight, single-binary tool that requires no complex installation. Simply download the binary and start the agent with a single command.

Manual Installation

👉 Download the Agent

You can download the ConHive Agent from the release page. The agent is available for both Windows and Linux.

👉 Extract the Archive

After downloading, extract the archive to reveal the agent binary. Copy the binary to your desired directory.

  • Linux:

    tar -xzf agent_Linux_x86_64.tar.gz

  • Windows:

    Use your preferred archive tool (e.g., 7-Zip) to extract the files.

🚀 Starting the Agent

Linux

Run the agent using:

./conhive-agent run

Windows

Run the agent using PowerShell:

.\conhive-agent.exe run

Docker

Alternatively, you can run the agent via Docker:

docker run ai2hive/conhive-agent:latest

📦 Automated Installation Script

For a quick and easy installation on Linux, use the provided installation script.

Quick Install

  1. Download the Installation Script:

    wget https://conhive.ai/hub/install_conhive_agent.sh -O install_conhive_agent.sh

  2. Make the Script Executable:

    chmod +x install_conhive_agent.sh

  3. Run the Installation Script:

    sudo ./install_conhive_agent.sh <CONHIVE_ENDPOINT> <CONHIVE_REGISTERTOKEN> <CONHIVE_DEVSLUG>
    • Replace <CONHIVE_ENDPOINT> with the endpoint for your ConHive setup (omit http:// or https://).
    • Replace <CONHIVE_REGISTERTOKEN> with your agent registration token.
    • Replace <CONHIVE_DEVSLUG> with your developer identifier.

  4. Verify Installation:

    Ensure the agent service is running by checking its status:

    sudo systemctl status conhive-agent.service

Detailed Installation Guide

This section provides a comprehensive step-by-step walkthrough for installing the ConHive Agent on your Linux device. For a quick setup, refer to the quick install instructions above.

Prerequisites

  • A Linux-based operating system
  • Root or sudo access
  • An active internet connection for downloading the installation script or binary

Installation Methods

Method 1: Using the Automated Installation Script

  1. Download the Installation Script:

    wget https://conhive.ai/hub/install_conhive_agent.sh -O install_conhive_agent.sh

  2. Set the Script Permissions:

    chmod +x install_conhive_agent.sh

  3. Execute the Installation Script:

    sudo ./install_conhive_agent.sh <CONHIVE_ENDPOINT> <CONHIVE_REGISTERTOKEN> <CONHIVE_DEVSLUG>

  4. Check Service Status:

    Verify that the ConHive Agent is running properly:

    sudo systemctl status conhive-agent.service

Method 2: Manual Setup

  1. Download and Extract the Agent:

    • Download the appropriate binary from the release page.

    • Extract the archive:

      tar -xzf agent_Linux_x86_64.tar.gz

  2. Copy the Binary:

    Move the conhive-agent binary to your preferred directory.

  3. Start the Agent:

    Navigate to the directory containing the binary and run:

    ./conhive-agent run

  4. Optional: Run as a Service

    For continuous operation, consider setting up the ConHive Agent as a system service. Refer to your Linux distribution’s documentation for creating a systemd service file.

By following these steps, you can quickly deploy the ConHive Agent on your device and begin managing your infrastructure with ease. Whether you choose the automated script or a manual setup, ConHive offers a flexible and efficient solution to meet your device management needs.

Appendices