OrpheAgent Binary Daemon: One-Click Installation Guide

This guide explains how to install the OrpheAgent Binary Daemon on a supported Linux system and provision the device through OrpheLink.

Step 1: Sign Up for an OrpheLink Account

• Apply for and register an OrpheLink account.
• Please register a new account by clicking the link below: Create a New Account

Step 2: Download OrpheAgent

• Download the corresponding OrpheAgent application for your operating system.

• Download from the O'Prueba website

Step 3: Extract the Downloaded File

• Extract the downloaded .tar.gz file:

tar -zxvf orphe-agent-1.1.1-binary.tar.gz

Step 4: Generate a Provision Key in OrpheLink

1. Log in to OrpheLink and navigate to the Provision page.

2. Generate and copy a new Provision Key for your device.

Step 5: Install with the One-Click Script

1. Run the script with the system architecture and an optional Provision Key:

sudo bash install.sh ARCH PROVISION_KEY

• ARCH: System architecture (e.g., amd64, arm64, armhf).
• PROVISION_KEY: Replace this with the Provision Key generated on the OrpheLink Provision page.

2. If you do not provide a Provision Key, you can register it manually after installation.

Step 6: Discover and Provision the New Agent in OrpheLink

1. Return to the OrpheLink Provision page and click Re-discover. The new agent will appear in the device list.

2. Select the OrpheAgent device, then click the Provision button at the bottom to let OrpheLink take over management.

3. After provisioning succeeds, verify that the device appears on the OrpheLink Inventory page.

Known Limitations and Notes

• Supported on Linux systems only (amd64, arm64, armhf).
• Automatic OTA update is not supported yet (manual upgrade required).
• Currently tested only on native Ubuntu 18.04, 20.04, 22.04, and 24.04.