Troubleshooting System Update Issues

No Updates Found

Symptom: Dermi Atlas Manager reports that no updates are available, even though a newer version exists.

Solutions:

1. An internet connection is required to check for updates. A 2-second connectivity check is performed.
2. The upgrade path may require intermediate versions. Not all versions can be upgraded directly to the latest release.
3. Ensure that releases.dermi.ai on port 443 is not blocked by a firewall.
4. Dermi Atlas Manager itself may need to be updated. A compatible version range is enforced between the manager and the system.

Update Download Fails

Symptom: The update download does not complete or fails with a verification error.

Solutions:

1. A minimum of 20 GB free disk space is required for updates.
2. A stable wired connection is recommended. VPN connections should be disabled during the download.
3. A "Downloaded content failed signature verification" error indicates a corrupted download. Retrying the download typically resolves this issue.
4. A valid license is required for downloading updates. For license issues, see Troubleshooting Licensing and Subscription Issues.

Update Fails During Installation

Symptom: The update fails after the download has completed, during the installation phase.

Solutions:

1. A pre-update backup can be restored through Dermi Atlas Manager.
2. If a "Failed to clean up resources" error appears, Docker Desktop should be restarted before retrying.
3. The entire update can be retried after addressing the root cause of the failure.