Install the Agent
Install ConHive Agent on any Linux device with a single command — the installer handles architecture detection, binary download, and systemd service setup automatically.
Prerequisites
Before you begin, make sure your device meets the following requirements:
| Requirement | Details |
|---|---|
| Operating system | Linux with systemd |
| Architecture | x86_64, arm64, or arm |
| Tools | curl or wget |
| Disk space | ~200 MB free (binary + download cache) |
| Network | Internet access to files.conhive.ai |
Install
Run the following command on your device:
curl -sSL https://files.conhive.ai/agent/install.sh | bash -s -- --variant=miniThe installer will:
- Detect your OS architecture
- Download the correct binary from
files.conhive.ai - Install it to
/usr/local/bin/conhive-agent - Register and start a
conhive-agentsystemd service - Run a health check on port 5050
Variants
Choose the variant that matches your use case:
| Variant | Profile | Use case |
|---|---|---|
mini | Sensor | IoT and embedded devices — lighter footprint, optimised for sensor workloads |
standard | Standard | Full-featured install for desktop or server deployments |
To install the standard variant:
curl -sSL https://files.conhive.ai/agent/install.sh | bash -s -- --variant=standardVerify the installation
Once the installer completes, confirm the service is running:
systemctl status conhive-agentYou should see active (running). The agent is now listening on port 5050.
Docker — Coming Soon
A Docker image for ConHive Agent is in development. Once available it will be published to the ConHive registry.
Get Started with ConHive Agent
ConHive Agent is a lightweight IoT device management platform that runs directly on your device. Go from zero to a running agent in minutes.
Open the UI & Initial Setup
Once the agent is running, open your browser and complete the one-time setup to create your admin account — this takes less than a minute.