Docker Not Detected
Symptom: The Requirements step of the Dermi Atlas Manager installer shows the Docker row as "Version: Not detected" with "Docker is not installed or not running.", or the Atlas Status page shows Docker Not Installed, Docker Not Running, or Docker Not Reachable.
Solutions:
- Not installed: Select Download Docker Desktop and install it. On Linux, install Docker Engine as described in Installing Docker for Dermi Atlas Professional.
- Not running: Select Start Docker Desktop. If Docker does not answer within two minutes, Atlas Manager shows "Could not start Docker Desktop"; start Docker Desktop from the Start menu or the Applications folder instead.
- Not reachable: "The Docker engine did not answer." means Docker is installed but not responding. Quit Docker Desktop fully and reopen it, or restart the Docker service on Linux.
- Linux permissions: Add the user account to the
docker group with sudo usermod -aG docker $USER, then sign out and back in.
- Version too old: Atlas requires Docker 28.0.0 or newer. A message beginning "Docker version" that states the required minimum means Docker must be upgraded.
After installing, starting, or upgrading Docker, select Refresh on the Requirements step.
Docker Desktop Will Not Start
Symptom: Docker Desktop stays on its starting screen and never becomes ready.
Solutions:
- Restart: Quit Docker Desktop fully and reopen it.
- Windows: Run
wsl --shutdown in PowerShell opened as administrator, then start Docker Desktop again.
- Factory reset: Docker Desktop offers "Reset to factory defaults" in its troubleshooting settings. A factory reset erases all Atlas data stored in Docker, including every patient record and image. Create a backup in Backup Management first if Atlas can still run, and contact Dermi support before resetting.
Memory or Disk Space Requirement Not Met
Symptom: The Requirements step shows a warning on the Memory, Disk Space, or Docker Disk Space row, and the installation cannot continue.
- Memory: The row counts the computer's total memory against the required 4 GB. A shortfall reads "This computer has X of RAM; at least 4 GB is required." The Docker Desktop memory setting does not change this row; the computer needs at least 4 GB of RAM.
- Disk Space: The row compares the free space on the drive that holds the Atlas Manager data with the required 20 GB. A shortfall reads "This computer has X free; at least 20 GB is required." Free space on that drive, then select Refresh.
- Docker Disk Space: The row reads "Available: X of Y (Required: 12 GB)". When the space is short, the row states the remedy: with Docker Desktop, "Increase the disk size limit in Docker Desktop settings under Resources, or remove unused images."; with Docker Engine, "Free space on the drive that holds the Docker data directory, or remove unused images." When the row reads "Not reported", the installation continues and the space is checked once the Atlas components are loaded.
A shortfall found during installation stops it with a message of the form "The Docker disk has X free of Y; at least Z is needed." followed by the same remedy. Apply the remedy and select Retry.
The minimums and the recommended values are listed in System Requirements.
Windows on ARM Computers
Symptom: On a Windows on ARM computer, Atlas does not install or run reliably.
Cause: On Windows, Atlas is published for Intel and AMD (x64) processors only. Windows on ARM computers are not supported.
Solution: Install Atlas on an Intel or AMD (x64) computer.
Related Articles
- Troubleshooting Atlas Installation and Start Issues for failures after the Requirements step
- Troubleshooting Dermi Atlas for sending diagnostics to Dermi support