203a4ee74b
This started as a "fix some links", but reading the section, I found various issues that could use some improvement. After that, I noticed that both the Windows and Mac pages had the same content, so I moved this to a common page instead. Note that there's still additional information that should likely be included (and perhaps a rewrite into "per topic" headings (containers, images, ...). Things that are missing; - backup/restore swarmkit configs - backup/restore swarmkit secrets - backup/restore CLI configuration, trust data etc. What I did in this pull request: - recommend pushing images to Docker Hub as the default approach to back up images (but kept `docker image save` as an alternative) - recommend `docker container commit` to save containers to an image, as doing so preserves both the container's configuration _and_ filesystem changes. `docker container export` only preserves the filesystem, but all other configuration is lost, which makes it hard to restore a container from it. Using `docker container commit` (committing the container to an image) also allows to follow the same procedure to backup containers as for images (both allowing them to be pushed to a registry, or to a file). - added some information about "wether or not" containers should be backed up, as it may not be needed to back up containers if all data is stored in volumes (best practice). - added some warnings regarding "sensitive data" (environment variables), and links to making repositories private before pushing. Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
5.5 KiB
description, keywords, title
| description | keywords | title |
|---|---|---|
| How to install Docker Desktop on Mac | mac, install, download, run, docker, local | Install Docker Desktop on Mac |
Docker Desktop for Mac is the Community version of Docker for Mac. You can download Docker Desktop for Mac from Docker Hub.
Download from Docker Hub{: .button .outline-btn}
By downloading Docker Desktop, you agree to the terms of the Docker Software End User License Agreement{: target="blank" rel="noopener" class=""} and the Docker Data Processing Agreement{: target="blank" rel="noopener" class=""}.
System requirements
Your Mac must meet the following requirements to successfully install Docker Desktop:
-
Mac hardware must be a 2010 or a newer model with an Intel processor, with Intel’s hardware support for memory management unit (MMU) virtualization, including Extended Page Tables (EPT) and Unrestricted Mode. You can check to see if your machine has this support by running the following command in a terminal:
sysctl kern.hv_supportIf your Mac supports the Hypervisor framework, the command prints
kern.hv_support: 1. -
macOS must be version 10.14 or newer. That is, Mojave, Catalina, or Big Sur. We recommend upgrading to the latest version of macOS.
If you experience any issues after upgrading your macOS to version 10.15, you must install the latest version of Docker Desktop to be compatible with this version of macOS.
Note
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). Docker Desktop currently supports macOS Mojave, macOS Catalina, and macOS Big Sur.
-
At least 4 GB of RAM.
-
VirtualBox prior to version 4.3.30 must not be installed as it is not compatible with Docker Desktop.
What's included in the installer
The Docker Desktop installation includes Docker Engine, Docker CLI client, Docker Compose, Notary, Kubernetes, and Credential Helper.
Install and run Docker Desktop on Mac
-
Double-click
Docker.dmgto open the installer, then drag the Docker icon to the Applications folder.
-
Double-click
Docker.appin the Applications folder to start Docker. (In the example below, the Applications folder is in "grid" view mode.)
The Docker menu in the top status bar indicates that Docker Desktop is running, and accessible from a terminal.
If you've just installed the app, Docker Desktop launches the onboarding tutorial. The tutorial includes a simple exercise to build an example Docker image, run it as a container, push and save the image to Docker Hub.
-
Click the Docker menu (
{: .inline}) to see
Preferences and other options. -
Select About Docker to verify that you have the latest version.
Congratulations! You are now successfully running Docker Desktop.
If you would like to rerun the tutorial, go to the Docker Desktop menu and select Learn.
Automatic updates
Starting with Docker Desktop 3.0.0, updates to Docker Desktop will be available automatically as delta updates from the previous version.
When an update is available, Docker Desktop automatically downloads it to your machine and displays an icon to indicate the availability of a newer version. All you need to do now is to click Update and restart from the Docker menu. This installs the latest update and restarts Docker Desktop for the changes to take effect.
Uninstall Docker Desktop
To uninstall Docker Desktop from your Mac:
- From the Docker menu, select Troubleshoot and then select Uninstall.
- Click Uninstall to confirm your selection.
Important
Uninstalling Docker Desktop destroys Docker containers, images, volumes, and other Docker related data local to the machine, and removes the files generated by the application. Refer to the back up and restore data section to learn how to preserve important data before uninstalling.
Where to go next
- Getting started provides an overview of Docker Desktop on Mac, basic Docker command examples, how to get help or give feedback, and links to other topics about Docker Desktop on Mac.
- Troubleshooting describes common problems, workarounds, how to run and submit diagnostics, and submit issues.
- FAQs provide answers to frequently asked questions.
- Release notes lists component updates, new features, and improvements associated with Docker Desktop releases.
- Get started with Docker provides a general Docker tutorial.
- Back up and restore data provides instructions on backing up and restoring data related to Docker.