Deploy in Minutes, Not Months

From unboxing to live monitoring in 15 minutes. Three deployment modes, seven provisioning methods, and zero vendor lock-in.

Three Deployment Modes

Production

Clean slate. Assets provisioned via USB/QR/CSV/cloud sync. For real deployments.

DEPLOYMENT_MODE=production

Development

Pre-loaded demo assets connecting to protocol simulators. For local dev with Docker Compose.

DEPLOYMENT_MODE=development

Demo

Mock data generation, no real device connections. For demos, testing, CI/CD.

DEPLOYMENT_MODE=demo

Quick Start

1
Flash SD Card
Download the image and flash to SD card
xzcat twinbox-edge-v1.0.0.img.xz | sudo dd of=/dev/sdX bs=4M
2
First Boot
Insert SD card and power on (~5 minutes: filesystem expansion, Docker startup, WiFi hotspot "TwinBox-Setup")
3
Setup Wizard
Connect to WiFi hotspot and open http://192.168.4.1
  • • Set admin password
  • • Configure network
  • • Select templates
4
Provision Assets
Choose your provisioning method: USB drive, QR scan, CSV import, or network discovery
5
Start Monitoring
Open dashboard at port 3000 and view real-time data

Seven Provisioning Methods

USB Drive Auto-Import

Insert USB with twinbox_config.csv or .yaml. Auto-detected via inotify. Marker file created after import.

POST /provisioning/usb/watch/start

QR Code Scan

Compact JSON format for equipment labels

{"id":"Pump_001","t":"pump","h":"192.168.1.10","s":[{"n":"vib_x","a":0}]}

CSV Bulk Import

Upload CSV via REST API. Format: asset_id, asset_type, protocol, host, port, sensors...

POST /provisioning/import/csv

YAML Import

Version-controlled configs for DevOps workflows. Ideal for GitOps deployments.

POST /provisioning/import/yaml

Cloud Sync

Device registered in cloud portal, assets pushed to edge on startup.

POST /provisioning/sync/cloud

Network Discovery

Scan Modbus (port 502), OPC UA (mDNS), BACnet (Who-Is), EtherNet/IP (CIP Identity).

POST /api/discover/scan

Device Clone

Export from master device, import to new devices for multi-site deployments. Ideal for identical installations.

POST /provisioning/clone

Hardware Requirements

ComponentMinimum (Hub Pro)Recommended (Hub Industrial)Maximum (Hub Rugged)
CPUARM Cortex-A76 4-coreIntel x86_64 4-coreIntel x86_64 8-core
RAM4GB8GB8GB+
Storage32GB SD64GB eMMC + M.2128GB SSD
NetworkGigabit EthernetDual GbE + 4G LTEDual GbE + 5G + GPS
Temp Range0°C to 50°C-20°C to 60°C-40°C to 70°C

Storage & Retention

Data TypeDefault RetentionStorage Estimate
Raw sensor data7 days~100MB/day (10 assets @ 10Hz)
1-minute aggregates30 days~5MB/day
1-hour aggregates365 days~500KB/day
1-day aggregates5 years~50KB/day
ML predictions90 days~10MB/day
Alert history365 days~1MB/day
Total (30 days)—~3.5GB

OTA Updates

Update Features

  • •Firmware updates via MQTT command or Dashboard UI
  • •SHA256 checksum verification
  • •Graceful service restart
  • •Automatic rollback on failure
  • •24-hour backup retention

Update Process

1
Download package
2
Verify checksum
3
Create backup
4
Apply update
5
Health check & rollback if needed

Monitoring Stack (Optional)

Metrics

  • • Prometheus (Port 9090)
  • • Grafana (Port 3001)
  • • cAdvisor (Port 8080)
  • • Node Exporter (Port 9100)

Logs

  • • Loki (Port 3100)
  • • Promtail
  • • Centralized log aggregation

Alerts

  • • AlertManager (Port 9093)
  • • Pre-built dashboards
  • • System health monitoring

Pre-built Dashboards

System Overview
ML Performance
OPC UA Connections

Ready to Deploy?

Start with our hardware or bring your own edge gateway