edgeiq/coda repository overview

⁠EdgeIQ Coda

EdgeIQ Coda is a lightweight, secure IoT edge agent designed for industrial and commercial IoT deployments. Optimized for resource-constrained environments, Coda provides reliable device connectivity, data collection, and secure communication with the EdgeIQ cloud platform.

For more details, review our public docs at https://dev.edgeiq.io/docs/installation-using-docker⁠.

⁠🚀 Features

• Lightweight & Efficient: Minimal resource footprint optimized for edge devices
• Multi-Architecture Support: Runs on both AMD64 and ARM64 architectures
• Secure Communication: Supports MQTT over SSL/TLS with certificate-based authentication
• Flexible Configuration: Easy configuration through environment variables and JSON config files
• TPM Support: Hardware security module integration for enhanced security
• AWS Greengrass Compatible: Seamless integration with AWS IoT Greengrass
• Real-time Monitoring: Built-in web UI for device monitoring and management
• REST API: HTTP API for device control and configuration

⁠📋 Prerequisites

• Docker installed on your system
• Valid EdgeIQ account and credentials
• Network connectivity to EdgeIQ cloud services

⁠🏃‍♂️ Quick Start

⁠Basic Usage

docker run -d \
  -e EDGE_COMPANY=your-company \
  -e EDGE_UNIQUE_ID=your-device-id \
  --name coda-agent \
  edgeiq/coda:latest

Required Environment Variables:

• EDGE_COMPANY: Your EdgeIQ company identifier
• EDGE_UNIQUE_ID: Unique identifier for your device

⁠Production Deployment

For production environments, use a specific version tag:

docker run -d \
  -e EDGE_COMPANY=your-company \
  -e EDGE_UNIQUE_ID=your-device-id \
  --name coda-agent \
  --restart unless-stopped \
  edgeiq/coda:v4.1.5

⁠⚙️ Configuration Options

⁠1. Default Configuration (Production)

Uses EdgeIQ production endpoints with basic authentication:

docker run -d \
  -e EDGE_COMPANY=your-company \
  -e EDGE_UNIQUE_ID=your-device-id \
  --name coda-agent \
  edgeiq/coda:latest

⁠2. Custom Configuration

Mount a custom configuration file for advanced settings:

docker run -d \
  -e EDGE_COMPANY=your-company \
  -e EDGE_UNIQUE_ID=your-device-id \
  -v /path/to/config.json:/opt/edge/conf/conf.json \
  --name coda-agent \
  edgeiq/coda:latest