Release types
Compose
A
docker-compose.yml, deployed and managed with docker compose -p iotmanager on the target device. Requires Docker + Docker Compose already installed on the device — see Prerequisites.Bash
An arbitrary shell script or command, run directly on the device. No Docker required — works on any registered device.
Deploying online
If the device is online (connected via its reverse tunnel), deploying is immediate:- Open a release from the Releases page and click Deploy.
- Select which device(s) to deploy to.
- Confirm — IoT Manager connects to each selected device and applies the release.
docker compose -p iotmanager up -d, tearing down the previous deployment first to avoid container name conflicts. Named volumes are automatically marked external: true to prevent Docker Compose from complaining about label ownership across deploys.
Deploying offline (air-gapped devices)
If a device has no internet access at all, see Offline Use — Compose releases can be packaged into a self-contained bundle (compose file + pre-pulled Docker images) and installed locally through the device’s own web UI, no cloud connectivity required for the device itself.Checking status
Each device shows its current running release, plus a health indicator:- Healthy — containers are running normally.
- Unhealthy — Docker reports at least one container in a restart loop.
- A container that’s intentionally stopped (
Exited) is not treated as unhealthy.