Peridiod Agent
The Peridio daemon (peridiod) is the on-device agent that handles OTA updates, remote access, and device communication with Peridio Core.
Overview
Peridiod runs as a system service on Linux devices, providing:
- Secure communication with Peridio Cloud
- Atomic A/B update management
- Remote access tunnel establishment
- Device health reporting
Getting Started
The fastest way to experience peridiod is through containerized devices:
pip install peridio-evk
peridio-evk devices-start --tag latest
Installation
Package Installation
# Debian/Ubuntu
wget -qO- https://packages.peridio.com/install.sh | bash
apt install peridiod
# RPM-based distributions
wget -qO- https://packages.peridio.com/install.sh | bash
yum install peridiod
Container Deployment
docker run -d --name peridio-agent \
--privileged \
-v /boot:/boot \
-v /data:/data \
peridio/peridiod:latest
Configuration
Peridiod uses a configuration file typically located at /etc/peridiod/peridio.conf
:
[device]
identifier = "device-001"
product_name = "my-product"
[authentication]
certificate_path = "/etc/peridiod/cert.pem"
private_key_path = "/etc/peridiod/private_key.pem"
[server]
url = "https://api.peridio.com"
Update Process
- Check - Periodic polling for available updates
- Download - Secure retrieval of update bundles
- Verify - Cryptographic signature validation
- Apply - Atomic installation to inactive partition
- Activate - Reboot to new system image
- Confirm - Health check and rollback protection
Remote Access
Peridiod enables remote device access through:
- Web Console - Browser-based terminal access
- SSH Tunnels - Secure shell connections via WireGuard
- Custom Services - Application-specific remote access