Docker

How to easily install and uninstall docker on MacOs

19 September 2026 · 8 min read

How to easily install and uninstall docker on MacOs

Are you a developer looking to streamline your workflow on macOS? One of the most powerful tools you can add to your arsenal is Docker. Docker simplifies application deployment by using containers to package up all the necessary components, such as code, runtime, system tools, and libraries, ensuring your application runs smoothly across different environments. This guide will walk you through how to easily install and uninstall Docker on macOS, even if you’re not a command-line wizard. We’ll provide step-by-step instructions and helpful tips to ensure a seamless experience. Docker’s popularity stems from its ability to create consistent and isolated environments, which are invaluable for development, testing, and deployment processes. Forget about the compatibility issues that plague traditional software setups; Docker solves those problems.

Preparing Your macOS for Docker Installation

Before diving into the installation process, it’s crucial to ensure your macOS environment is ready for Docker. This involves checking system requirements and potentially updating your operating system. Docker Desktop, the most common way to run Docker on macOS, requires macOS Mojave 10.14 or newer. Older versions of macOS may require Docker Toolbox, which is now deprecated but still usable if necessary. Make sure you have at least 4 GB of RAM and virtualization enabled on your machine. Virtualization allows Docker to run containers efficiently. You can check if virtualization is enabled in your BIOS/UEFI settings. Regularly updating your macOS ensures that you have the latest security patches and system optimizations, which contribute to a smoother Docker experience. A clean and updated system minimizes potential conflicts and compatibility issues during installation.

Another important step is to verify that you have administrative privileges on your macOS account. Installing Docker requires these privileges as it involves making system-level changes. If you’re using a corporate or shared computer, you might need to contact your IT administrator for assistance. Furthermore, it’s a good practice to close any unnecessary applications before starting the installation. This frees up system resources and reduces the likelihood of interruptions. Finally, consider backing up your important data before making any major system changes. While Docker installation is generally safe, having a backup provides an extra layer of protection against unforeseen issues.

Installing Docker Desktop on macOS: A Step-by-Step Guide

Installing Docker Desktop on macOS is a straightforward process. First, download the Docker Desktop installer from the official Docker website (Docker Desktop Download). Ensure you’re downloading the version compatible with your macOS. Once downloaded, double-click the .dmg file to open the installer. Drag the Docker icon to the Applications folder to begin the installation. This copies the Docker Desktop application to your system. After the files are copied, open Docker Desktop from the Applications folder. You might be prompted to enter your administrator password to authorize the installation. After that, Docker Desktop will start, and you’ll see the Docker icon in your menu bar.

Once Docker Desktop is running, it will prompt you to accept the Docker Subscription Service Agreement. Read the agreement carefully before accepting it. The first time you run Docker Desktop, it might take a few minutes to initialize the Docker engine. Be patient and allow the process to complete. After initialization, you can verify that Docker is installed correctly by opening a terminal window and running the command docker --version. This should display the installed Docker version. You can also run docker run hello-world to test if Docker containers are running properly. This command downloads a test image and runs it in a container, printing a greeting message to your terminal. This confirms that Docker is correctly configured and ready to use.

Here’s a summary of the installation steps:

  1. Download the Docker Desktop installer.
  2. Open the .dmg file and drag the Docker icon to the Applications folder.
  3. Open Docker Desktop from the Applications folder.
  4. Accept the Docker Subscription Service Agreement.
  5. Verify the installation using docker --version and docker run hello-world.

Uninstalling Docker Desktop from macOS: A Comprehensive Guide

Sometimes, you might need to uninstall Docker Desktop from your macOS. Perhaps you’re troubleshooting an issue, switching to a different containerization solution, or simply cleaning up your system. Uninstalling Docker Desktop is generally a clean process, but it’s important to follow the correct steps to ensure all components are removed. The easiest way to uninstall Docker Desktop is through the application’s menu. Click the Docker icon in your menu bar, select “Troubleshoot,” and then choose “Uninstall.” This will initiate the uninstallation process. You will be prompted to confirm your decision and enter your administrator password. After confirmation, Docker Desktop will remove itself from your system.

However, sometimes remnants of Docker Desktop might remain on your system. To ensure a complete removal, you can manually delete the following files and folders: ~/Library/Application Support/Docker Desktop, ~/Library/Preferences/com.docker.docker.plist, /usr/local/bin/docker, /usr/local/bin/docker-compose, and /Applications/Docker.app. You can use the Finder or the Terminal to delete these files. Be cautious when deleting system files, and double-check the paths to avoid accidentally removing important data. After deleting these files, restart your computer to ensure that all changes take effect. This ensures that any lingering processes are terminated and that the system is completely clean. A clean uninstall helps prevent conflicts if you decide to reinstall Docker Desktop later.

The following points highlight the benefits of proper Docker uninstallation:

  • Frees up disk space.
  • Prevents conflicts during future installations.
  • Ensures a clean system state.

Troubleshooting Common Docker Installation and Uninstallation Issues

Even with a straightforward installation process, you might encounter issues when installing or uninstalling Docker on macOS. One common problem is insufficient system resources. Docker requires a certain amount of RAM and CPU power to run efficiently. If your computer is running low on resources, Docker might fail to install or run properly. Close any unnecessary applications to free up resources. Another common issue is conflicting software. If you have other virtualization software installed, such as VirtualBox or VMware, they might conflict with Docker. Try disabling or uninstalling these programs temporarily to see if it resolves the issue. Firewall and antivirus software can also interfere with Docker’s network connections. Ensure that Docker is allowed through your firewall and that your antivirus software isn’t blocking its network traffic (Docker Security Best Practices).

During uninstallation, you might encounter errors if Docker processes are still running. Make sure to quit Docker Desktop completely before attempting to uninstall it. You can use the Activity Monitor to check for any running Docker processes and force-quit them if necessary. If you’re still having trouble, try restarting your computer and then attempting the uninstallation again. If manual file deletion is required, double-check the file paths to avoid accidentally deleting important system files. Always exercise caution when working with system files. Consult the Docker documentation or online forums for solutions to specific error messages. The Docker community is generally very helpful and can provide valuable troubleshooting tips.

To summarize, here are some common issues and their solutions:

  • Insufficient system resources: Close unnecessary applications.
  • Conflicting software: Disable or uninstall other virtualization software.
  • Firewall or antivirus interference: Allow Docker through your firewall.
  • Running Docker processes: Quit Docker Desktop completely.

Docker Desktop requires macOS Mojave 10.14 or newer, at least 4 GB of RAM, and virtualization enabled. If you encounter installation problems, ensure your system meets these requirements. If issues persist, try restarting your computer, disabling conflicting software, and checking your firewall settings. Additionally, ensure no Docker processes are running before starting the uninstallation.

FAQ: Docker Installation and Uninstallation on macOS

Q: What are the system requirements for Docker Desktop on macOS?
A: Docker Desktop requires macOS Mojave 10.14 or newer, at least 4 GB of RAM, and virtualization enabled.
Q: How do I verify that Docker is installed correctly?
A: Open a terminal window and run the command `docker --version`. You can also run `docker run hello-world` to test if Docker containers are running properly.
Q: How do I completely uninstall Docker Desktop from macOS?
A: Use the uninstaller from the Docker menu. Then, manually delete the following files and folders: `~/Library/Application Support/Docker Desktop`, `~/Library/Preferences/com.docker.docker.plist`, `/usr/local/bin/docker`, `/usr/local/bin/docker-compose`, and `/Applications/Docker.app`.
Q: What should I do if I encounter errors during installation?
A: Ensure your system meets the minimum requirements, close conflicting software, check your firewall settings, and restart your computer.
Q: Is Docker free to use?
A: Docker Desktop is free for personal use and small businesses. Larger organizations may require a paid subscription ([Mirantis Docker Desktop Alternative](https://www.mirantis.com/blog/docker-desktop-is-no-longer-free-but-mirantis-offers-an-alternative)).
Mastering Docker on macOS empowers you to build, ship, and run applications with unparalleled efficiency. By following these instructions, you can confidently manage your Docker environment, ensuring smooth development workflows and consistent deployments. Remember to regularly update Docker Desktop to benefit from the latest features and security enhancements. If you're looking to delve deeper into containerization, explore resources on Docker Compose and Kubernetes to orchestrate multi-container applications. Don't hesitate to join online communities and forums like Stack Overflow ([Stack Overflow](https://stackoverflow.com/)) for support and guidance as you continue your Docker journey. Consider exploring [advanced Docker networking configurations](https://courthousezoological.com/n7sqp6kh?key=e6dd02bc5dbf461b97a9da08df84d31c) to further enhance your skills.

Question & Answer :
My question is

How to easily install docker to have it available in terminal and how to uninstall docker on osx?

To Install:

  1. Go Here
  2. Click the “Get Docker” or “Get Docker Desktop for Mac (Stable)” button.
  3. Double-click the DMG
  4. Drag Docker into Applications
  5. Open Docker
  6. Open Terminal after install and docker will be available. Docker should auto-launch on subsequent startups and be available on command line.

To Uninstall:

  1. Click On Docker Icon
  2. Select Preferences
  3. Select Bug Icon (Question Mark or Bomb Icon icon in some versions of Docker UI) for the Troubleshoot menu
  4. Select Uninstall

An image of Troubleshoot menu that includes Uninstall button