๐ System requirements
Mac with Intel chip:
A supported version of macOS
At least 4 GB of RAM
Docker supports Docker Desktop on the most recent versions of macOS. That is, the current release of macOS and the previous two releases. As new major versions of macOS are made generally available, Docker stops supporting the oldest version and supports the newest version of macOS (in addition to the previous two releases).
Mac with Apple silicon:
A supported version of macOS
At least 4 GB of RAM
Beginning with Docker Desktop 4.3.0, we have removed the hard requirement to install Rosetta 2. There are a few optional command line tools that still require Rosetta 2 when using Darwin/AMD64. See Known issues. However, to get the best experience, we recommend that you install Rosetta 2. To install Rosetta 2 manually from the command line, run the following command:
$ softwareupdate --install-rosetta
๐ Install and run Docker Desktop on Mac
Install interactively:
Go to the Docker website and download Docker Desktop for Mac from the following URL: docker.com/products/docker-desktop.
Double-click
Docker.dmg
to open the installer, then drag the Docker icon to the Applications folder. By default, Docker Desktop is installed at/Applications/Docker.app
.Double-click
Docker.app
in the Applications folder to start Docker.The Docker menu displays the Docker Subscription Service Agreement.
Hereโs a summary of the key points:
Docker Desktop is free for personal use, education, and non-commercial open source projects.
Otherwise, it requires a paid subscription for professional use.
Install from the command line:
After downloading Docker.dmg
from either the download buttons at the top of the page or from the release notes, run the following commands in a terminal to install Docker Desktop in the Applications folder:
$ sudo hdiutil attach Docker.dmg
$ sudo /Volumes/Docker/Docker.app/Contents/MacOS/install
$ sudo hdiutil detach /Volumes/Docker
By default, Docker Desktop is installed at /Applications/Docker.app
. As macOS typically performs security checks the first time an application is used, the install
command can take several minutes to run.
The install
command accepts the following flags:
--accept-license
: Accepts the Docker Subscription Service Agreement now, rather than requiring it to be accepted when the application is first run.--allowed-org=<org name>
: Requires the user to sign in and be part of the specified Docker Hub organization when running the application.--user=<username>
: Performs the privileged configurations once during installation. This removes the need for the user to grant root privileges on first run. To find the username, enterls /Users
in the CLI.--admin-settings
: Automatically creates anadmin-settings.json
file which is used by administrators to control certain Docker Desktop settings on client machines within their organization.--proxy-http-mode=<mode>
: Sets the HTTP Proxy mode. The two modes aresystem
(default) ormanual
.--override-proxy-http=<URL>
: Sets the URL of the HTTP proxy that must be used for outgoing HTTP requests. It requires--proxy-http-mode
to bemanual
.--override-proxy-https=<URL>
: Sets the URL of the HTTP proxy that must be used for outgoing HTTPS requests, requires--proxy-http-mode
to bemanual.
--override-proxy-exclude=<hosts/domains>
: Bypasses proxy settings for the hosts and domains. It's a comma-separated list.