Brinkhaus openXEdge
How-to v2

You want to install a new firmware version on a single openXEdge.

Prerequisites

  • You are logged in as admin (or any user with the settings permission)
  • The edge has a working internet or at least VPN connection to update.brinkhaus-gmbh.de

Steps

  1. Click the cog icon in the top-right → you land on the settings page.

  2. Pick Update in the left sidebar.

  3. You see the currently installed version on top, the versions of all running Docker services in the middle, and the available-versions list from the Brinkhaus Update Server at the bottom.

    Settings → Update — current version, service table, available versions

  4. Find the target version (typically the latest). Click the note icon next to a version to read its release notes.

  5. Click Upgrade (or Downgrade for older versions).

  6. The edge downloads the signed compose file from the update server, verifies the Ed25519 signature, stages the files for the UpdateService, and starts the update process automatically.

  7. During the update the UI is briefly unreachable. After a successful health check (typically 1–2 minutes) you are logged back in; on failure the edge automatically rolls back to the previous version.

Troubleshooting

  • Update stuck on “downloading” → check the internet connection, reboot the edge if needed and retry.
  • A service stays in “rollback” after the update → check Settings → Diagnosis for the offending service; codes are explained on Diagnosis codes.
  • No versions are listed → enable “Expert Mode” top-right and check that the update-server URL is correct; usually https://update.brinkhaus-gmbh.de.