Installing Docker for Dermi Atlas Professional

Overview

Dermi Atlas Professional runs inside Docker containers. This architecture improves security, simplifies updates, and ensures consistent operation. Docker must be installed and configured on the host computer before deploying Dermi Atlas Professional. Dermi Atlas Professional requires Docker 28.0.0 or later.

Docker Desktop vs Docker Engine

• Docker Desktop (Recommended): Provides a graphical interface and simplified management. Best for Windows and macOS users.
• Docker Engine: Command-line only. Suitable for Linux servers and advanced users.

Installing Docker Desktop on Windows

1. Download Docker Desktop from docker.com/products/docker-desktop.
2. Run the installer and follow the prompts.
3. Ensure WSL 2 is selected as the backend when prompted (recommended).
4. Complete installation and restart the computer if required.
5. Launch Docker Desktop from the Start menu.

Installing Docker Desktop on macOS

1. Download Docker Desktop from docker.com/products/docker-desktop.
2. Open the .dmg file and drag Docker to the Applications folder.
3. Launch Docker from Applications.
4. Enter the administrator password to install helper components.

Installing Docker Engine on Linux

Example for Ubuntu 22.04+ or Debian 12+; any Linux distribution with Docker Engine 28.0.0 or later is supported.

• Update package index and install prerequisites:

sudo apt-get update
sudo apt-get install ca-certificates curl gnupg

• Add Docker's official GPG key and repository (refer to Official Docker Documentation for the latest commands).
• Install Docker Engine:

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

• Add the current user to the docker group:

sudo usermod -aG docker $USER

• Log out and back in for the group change to take effect.

Configuring Docker Resources

The actual deployment of Dermi Atlas Professional, including requirement validation, is driven by Dermi Atlas Manager. The resource guidance below is optional. On Docker Desktop, ensure at least 4GB of memory and roughly 20GB of free disk are available to the Docker VM (Settings => Resources). Docker Engine on Linux uses host resources directly and needs no equivalent setting.

In Docker Desktop

1. Open Docker Desktop.
2. Navigate to Settings (gear icon) => Resources.
3. Configure the following:

• Memory: At least 4GB (8GB+ recommended)
• Disk: At least 20GB free (additional headroom recommended for clinical image storage)

1. Click Apply & Restart.

Higher memory allocation benefits features such as automatic image alignment, which performs memory-intensive processing within the Docker environment.

Configure Automatic Startup

1. Navigate to Settings => General.
2. Enable Start Docker Desktop when you sign in to your computer.
3. Click Apply.

Verifying Installation

Open a terminal or command prompt and run:

docker --version

Version information should be displayed. Confirm the reported version is 28.0.0 or higher. Run docker run hello-world to test that containers can launch successfully.

Next Steps

After Docker is installed, install Installing Dermi Atlas Manager, then follow Deploying Dermi Atlas Professional. Dermi Atlas Manager performs the deployment and validates these requirements.