Install Docker Desktop
For local development and testing, EML AdminTool runs on macOS and Windows via Docker Desktop. This setup is not suitable for production — for a public deployment, follow the Production setup guide instead.
System requirements
- A supported version of macOS (current release and the two previous major versions).
- At least 4 GB of RAM.
On Apple Silicon, installing Rosetta 2 is recommended for full compatibility:
softwareupdate --install-rosettaInstallation
- Download Docker Desktop from the official release page.
- Open the downloaded
.dmgfile and drag Docker to the Applications folder. - Launch Docker from Applications.
- Accept the Docker Subscription Service Agreement when prompted.
Note
Docker Desktop is free for personal use and open-source projects. Commercial use requires a paid subscription. See Docker’s pricing page for details.
System requirements
Docker Desktop on Windows requires either WSL 2 or Hyper-V as a backend. WSL 2 is recommended.
- Windows 10 64-bit, version 22H2 or later, or Windows 11 64-bit, version 23H2 or later.
- At least 4 GB of RAM.
- Hardware virtualization enabled in BIOS/UEFI.
Install or update WSL 2
Open PowerShell as administrator and run:
wsl --installIf WSL is already installed, update it:
wsl --updateRestart your machine if prompted.
Install Docker Desktop
- Download Docker Desktop from the official release page.
- Run the installer (
Docker Desktop Installer.exe). - On the configuration screen, ensure Use WSL 2 instead of Hyper-V is selected.
- Follow the wizard to completion, then start Docker Desktop from the Start menu.
- Accept the Docker Subscription Service Agreement when prompted.
If your Windows user account is different from the account used to install Docker Desktop, add your user to the docker-users group: open Computer Management as administrator, navigate to Local Users and Groups > Groups > docker-users, and add your account. Sign out and back in for the change to take effect.
Verify the installation
Open a terminal and run:
docker run hello-worldYou should see a confirmation message. Docker Desktop is ready.