Installing Docker for Dermi Atlas Professional

Dermi Atlas Manager runs Dermi Atlas Professional in Docker, which must be installed on the host computer before the Requirements step of the Atlas installation passes. Atlas requires Docker Engine 28.0.0 or later:

• Windows and macOS: Docker Desktop, which includes Docker Engine.
• Linux: Docker Engine, installed from Docker's package repository.

Docker Desktop on Windows

1. Download Docker Desktop from docker.com/products/docker-desktop.
2. Run the installer and keep WSL 2 selected as the backend when asked.
3. Restart the computer if the installer asks for it.
4. Open Docker Desktop from the Start menu and wait until it reports that it is running.

Docker Desktop on macOS

1. Download Docker Desktop for Mac with Apple silicon from docker.com/products/docker-desktop.
2. Open the .dmg file and drag Docker to the Applications folder.
3. Open Docker from Applications and enter the administrator password when asked.
4. In Docker Desktop, open Settings => General, select Apple Virtualization framework as the virtual machine manager, turn on Use Rosetta for x86_64/amd64 emulation on Apple Silicon, and select Apply. Atlas runs on Apple silicon through Rosetta.

Docker Engine on Linux

1. Add Docker's package repository by following Docker's installation guide for the distribution.

2. Install Docker Engine:

   CopyCopied

   sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

3. Add the user who runs Dermi Atlas Manager to the docker group:

   CopyCopied

   sudo usermod -aG docker $USER

4. Sign out and back in so that the group change takes effect.

Docker Desktop Settings

Open Docker Desktop and select the gear icon to open Settings:

• Start with the computer: Under General, turn on Start Docker Desktop when you sign in to your computer and select Apply. Atlas starts again with Docker after the computer restarts; without this setting, Atlas stays unavailable until someone opens Docker Desktop.
• Disk space: Under Resources, the disk size limit must leave at least 12 GB free, which the Docker Disk Space row of the Requirements step checks. A limit of 100 GB or more leaves room for photos and updates.
• Memory on macOS: Atlas runs within the memory assigned to Docker Desktop under Resources. Keep it at 4 GB or more.

Docker Engine on Linux starts with the computer and uses the host's memory and disk directly, so it needs no equivalent settings.

Checking Docker in Atlas Manager

The Docker row of the Requirements step shows the Docker version Atlas Manager found:

• When Docker Desktop is installed but not running on Windows or macOS, select Start Docker Desktop.
• When Docker is not found, the step shows Download Docker Desktop on Windows and macOS, or Open Installation Guide on Linux. Install Docker as described above, then select Refresh.

Next Step

Install Dermi Atlas Manager, then follow Deploying Dermi Atlas Professional.