Setting Up Your Edge Device

This comprehensive guide will walk you through setting up your edge device to work with Cliff.

System Requirements

Your edge device should meet these requirements:

• Linux-based operating system (Ubuntu 20.04+ recommended)
• ARM64 or AMD64 architecture
• At least 2GB RAM
• 10GB free disk space
• Network connectivity

Installation Methods

Method 1: Quick Install Script

The easiest way to install the Cliff agent:

curl -fsSL https://get.cliff.com | bash

Method 2: Manual Installation

• Download the agent package for your architecture
• Extract the archive
• Run the installation script
• Configure the agent with your provision key

Configuration

After installation, you'll need to configure the agent:

• Obtain a provision key from your dashboard
• Run the configuration command:

   cliff-agent configure --key YOUR_PROVISION_KEY

• Start the agent service:

   sudo systemctl start cliff-agent
   sudo systemctl enable cliff-agent

Verification

To verify your device is connected:

• Check the agent status:

   sudo systemctl status cliff-agent

• View the device in your dashboard
• The device should show as "Connected" with a green status indicator

Troubleshooting

If your device doesn't appear:

• Check network connectivity
• Verify the provision key is correct
• Review agent logs: sudo journalctl -u cliff-agent -f
• Ensure firewall rules allow outbound connections

Security Considerations

• Keep your provision keys secure
• Regularly update the agent software
• Use SSH key authentication for device access
• Enable firewall rules to restrict access