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 using the Restore Backup option in the Dermi Atlas Manager installation wizard.
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.

System Requirements Not Met

Symptom: A pre-update validation check reports that system requirements are not met.

Solutions:

1. Docker version 28.0.0 or later is required. The current version can be checked with the following command:

docker --version

1. A minimum of 4 GB memory must be allocated to Docker (Settings > Resources > Memory).
2. A minimum of 20 GB free disk space is required.

System in Inconsistent State After Failed Update

Symptom: The system is in a broken or inconsistent state after a failed update.

Solutions:

1. Restoring from a backup through Dermi Atlas Manager is the safest recovery option.
2. If the failure was transient, retrying the update may resolve the issue.
3. A full cleanup and reinstall can be performed as a last resort. Note: this removes all data.
4. Contact support at support@dermi.ai with error details and logs for additional assistance.