How-to v2
The openXEdge can also install firmware updates without an internet connection from a USB stick (available as of firmware 2.10.0). Signature verification, the progress screen, and automatic rollback behave exactly as they do for an online update.
What belongs on the stick
The root directory of the USB stick must contain:
| File | Purpose |
|---|---|
docker-compose.yml | The firmware definition of the target version |
a *.sig file | Ed25519 signature of the compose file (any name with the .sig extension) |
a *.pem file | Public key for the signature verification (any name with the .pem extension) |
description.json | optional — version description |
You receive this package from Brinkhaus or from the customer portal.
Steps
- Log in on the edge and open Settings → Update.
- Expand the “Offline update” section at the bottom of the page.
- Insert the USB stick. The stick is mounted automatically during the scan — no manual mounting required. Detected sticks with a valid firmware package appear in the list; if multiple packages are found, the one with the highest version is preselected.
- Start the installation. The edge verifies the Ed25519 signature locally; the package is only staged for the UpdateService if the signature is valid.
- The remainder of the process is identical to an online update: progress screen with phase display, health check, and automatic rollback to the previous version on failure.
Troubleshooting
- Stick is not detected → Remove the stick, re-insert it, and open the offline-update section again; try a different stick (FAT32/exFAT) if needed.
- “Signature invalid” → The package was modified or belongs to a different stream. Do not install; obtain the package again. See Diagnosis codes (code 2008).
Related
- Update firmware — the normal online path
- How updates work