--- title: How to Fix 'Cannot Connect to the Docker Daemon' on macOS description: Running into the 'Cannot connect to Docker daemon' error on macOS can hinder your work. To fix this, first ensure Docker Desktop is running. Check the Docker... canonical: https://daily.dev/posts/how-to-fix-cannot-connect-to-the-docker-daemon-on-macos-znxsvnqp4 twitter:card: summary_large_image twitter:site: @dailydotdev og:type: website og:site_name: daily.dev og:title: How to Fix 'Cannot Connect to the Docker Daemon' on macOS | daily.dev og:description: Running into the 'Cannot connect to Docker daemon' error on macOS can hinder your work. To fix this, first ensure Docker Desktop is running. Check the Docker... og:url: https://daily.dev/posts/how-to-fix-cannot-connect-to-the-docker-daemon-on-macos-znxsvnqp4 og:image: https://api.daily.dev/og/posts/zNXsVnQP4.png og:image:alt: How to Fix 'Cannot Connect to the Docker Daemon' on macOS og:image:width: 1200 og:image:height: 630 og:locale: en --- > ## Documentation Index > Fetch the complete documentation index at: https://daily.dev/llms.txt > Use this file to discover all available pages before exploring further. # How to Fix 'Cannot Connect to the Docker Daemon' on macOS **[Collections](https://daily.dev/sources/collections)** · 2 min read · 1 upvotes · 0 comments ## Summary Running into the 'Cannot connect to Docker daemon' error on macOS can hinder your work. To fix this, first ensure Docker Desktop is running. Check the Docker daemon status using the terminal command 'sudo systemctl status docker'. If permission issues arise, modify them by running 'sudo chmod 666 /var/run/docker.sock'. Verify that your environment variables are correctly set. For advanced troubleshooting, enable debug mode and review the Docker Desktop logs found at '~/Library/Containers/com.docker.docker/Data/log/vm/dockerd.log'. If problems persist, contact Docker support. ## Content # How to Fix 'Cannot Connect to the Docker Daemon' on macOS Experiencing the 'Cannot connect to Docker daemon' error on macOS can be frustrating and disrupt your workflow. This guide offers a comprehensive approach to diagnose and resolve this issue effectively. Here are the key steps to address this problem: ## Ensure Docker Desktop is Running First, verify that Docker Desktop is running on your macOS. You can check this by looking for the Docker icon in your system tray. If it is not running, start Docker Desktop before proceeding with other troubleshooting steps. ## Check Docker Daemon Status Sometimes, the Docker daemon might not be active. To check the status of the Docker daemon, open your terminal and run the following command: ```sh sudo systemctl status docker ``` This command will show the current status of the Docker daemon. Ensure that it is active and running. ## Modify Permissions Permission issues can prevent Docker from connecting to the daemon. Check and modify the permissions of your Docker socket by running: ```sh sudo chmod 666 /var/run/docker.sock ``` This command grants all users read and write permissions to the Docker socket. ## Inspect Environment Variables Incorrect or misconfigured environment variables can also cause connection issues. Ensure that your environment variables are set correctly in your shell configuration files (e.g., `.bashrc`, `.zshrc`). Add the following lines if they are missing: ```sh export DOCKER_HOST=unix:///var/run/docker.sock ``` ## Advanced Troubleshooting If the problem persists, consider enabling debug mode and reviewing Docker Desktop logs for deeper insights. ### Enable Debug Mode To enable debug mode, open Docker Desktop, go to the settings, and enable the debug option under the 'General' tab. This will provide more detailed logs for troubleshooting. ### Review Docker Desktop Logs Inspecting Docker Desktop logs can give you clues about what might be going wrong. Logs can be found at `~/Library/Containers/com.docker.docker/Data/log/vm/dockerd.log`. By following these steps, you should be able to diagnose and resolve the 'Cannot connect to Docker daemon' error on macOS effectively. If the issue persists, consider reaching out to Docker support for further assistance. ## Similar posts on daily.dev - [Don’t just attend KubeCon \+ CloudNativeCon, Merge Forward your experience\!](https://daily.dev/posts/don-t-just-attend-kubecon-cloudnativecon-merge-forward-your-experience--l0rpp73x8) · CNCF · 1 upvotes · 0 comments - [Announcing H2 2026 KCDs](https://daily.dev/posts/announcing-h2-2026-kcds-m96goajm1) · CNCF · 1 upvotes · 0 comments - [Two months of Open Community Groups](https://daily.dev/posts/two-months-of-open-community-groups-asf52zhbs) · CNCF · 0 upvotes · 0 comments - [CNCF Unveils Schedule for KubeCon \+ CloudNativeCon Europe 2026](https://daily.dev/posts/cncf-unveils-schedule-for-kubecon-cloudnativecon-europe-2026-ikhcoa5cb) · CNCF · 2 upvotes · 0 comments - [CNCF Debuts KubeCon \+ CloudNativeCon Japan 2026 Schedule](https://daily.dev/posts/cncf-debuts-kubecon-cloudnativecon-japan-2026-schedule-xp5pyudub) · CNCF · 1 upvotes · 0 comments --- Tags: [#devops](https://daily.dev/tags/devops), [#docker](https://daily.dev/tags/docker), [#containers](https://daily.dev/tags/containers), [#mac](https://daily.dev/tags/mac) [View this post on daily.dev](https://daily.dev/posts/how-to-fix-cannot-connect-to-the-docker-daemon-on-macos-znxsvnqp4) ```json {"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://daily.dev/#organization","name":"daily.dev","url":"https://daily.dev","logo":{"@type":"ImageObject","url":"https://daily.dev/apple-touch-icon.png","width":180,"height":180},"sameAs":["https://twitter.com/dailydotdev","https://github.com/dailydotdev","https://www.linkedin.com/company/daily-dev-ltd"]},{"@type":"WebSite","@id":"https://daily.dev/#website","url":"https://daily.dev","name":"daily.dev","publisher":{"@id":"https://daily.dev/#organization"},"potentialAction":{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https://daily.dev/search?q={search_term_string}"},"query-input":"required name=search_term_string"}}]} {"@context":"https://schema.org","@type":"TechArticle","headline":"How to Fix 'Cannot Connect to the Docker Daemon' on macOS","url":"https://daily.dev/posts/how-to-fix-cannot-connect-to-the-docker-daemon-on-macos-znxsvnqp4","mainEntityOfPage":{"@type":"WebPage","@id":"https://daily.dev/posts/how-to-fix-cannot-connect-to-the-docker-daemon-on-macos-znxsvnqp4"},"datePublished":"2024-12-08T10:13:20.336Z","dateModified":"2024-12-08T22:10:47.145Z","description":"Running into the 'Cannot connect to Docker daemon' error on macOS can hinder your work. To fix this, first ensure Docker Desktop is running. Check the Docker...","image":"https://media.daily.dev/image/upload/f_auto,q_auto/v1/posts/9e15069bd54bbc3e3d51cdb42a970990?_a=AQAEuj9","thumbnailUrl":"https://media.daily.dev/image/upload/f_auto,q_auto/v1/posts/9e15069bd54bbc3e3d51cdb42a970990?_a=AQAEuj9","isAccessibleForFree":true,"articleSection":"Collections","inLanguage":"en","publisher":{"@type":"Organization","name":"daily.dev","url":"https://daily.dev","logo":{"@type":"ImageObject","url":"https://daily.dev/apple-touch-icon.png","width":180,"height":180}},"author":{"@type":"Organization","name":"Collections","logo":"https://media.daily.dev/image/upload/s--fk_6ycEi--/f_auto,q_auto/v1780996001/logos/collections?_a=BAMAMiWQ0","url":"https://daily.dev/sources/collections"},"commentCount":0,"discussionUrl":"https://daily.dev/posts/how-to-fix-cannot-connect-to-the-docker-daemon-on-macos-znxsvnqp4","interactionStatistic":[{"@type":"InteractionCounter","interactionType":{"@type":"LikeAction"},"userInteractionCount":1},{"@type":"InteractionCounter","interactionType":{"@type":"CommentAction"},"userInteractionCount":0}],"keywords":"devops,docker,containers,mac","timeRequired":"PT2M"} {"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://daily.dev"},{"@type":"ListItem","position":2,"name":"Collections","item":"https://daily.dev/sources/collections"},{"@type":"ListItem","position":3,"name":"How to Fix 'Cannot Connect to the Docker Daemon' on macOS"}]} ```