Docker Not Detected
Symptom: The Requirements step of the Dermi Atlas Manager installer shows "Docker is not installed or not running." in the Docker row, or the Docker card on the Atlas Status page reads Not Installed, Not Running, or 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: "Restart Docker to restore the connection." 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 Engine 29.0.0 or later. "Docker version X is installed; at least 29.0.0 is required." means Docker must be upgraded.
After installing, starting, or upgrading Docker, select Refresh, the icon at the top right of the list 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, not the Docker Desktop memory setting. A shortfall reads "This computer has X of RAM; at least 4.00 GiB is required."
- Disk Space: The row checks the free space on the drive that holds the Atlas Manager data. A shortfall reads "This computer has X free; at least 20.00 GiB is required. Free up space, then try again." Free space on that drive, then select Refresh.
- Docker Disk Space: A passing row shows the free space on the disk Docker uses. When the row begins "The Docker disk limit could not be read.", the installation continues and the space is checked once the Atlas components are loaded. A failing row reads "The Docker disk has X free of Y; at least 12.00 GiB is needed." or "The drive that holds the Docker data has X free of Y; at least 12.00 GiB is needed.", followed by its remedy. Apply the remedy, then select Refresh.
A shortfall found during installation stops it with one of the same two messages, with the space it needs in place of 12.00 GiB. 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