> For the complete documentation index, see [llms.txt](https://kevindebruno.gitbook.io/worker-troubleshooting-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kevindebruno.gitbook.io/worker-troubleshooting-guide/environment-setup-guide/mac-os.md).

# Mac OS

To ensure that Docker runs smoothly on your Mac device, you must ensure the following four conditions:

#### 1. Use an Apple Chip Device

Your Mac device must be equipped with an Apple chip. Do the following steps to check

* On your Mac, click the Apple icon in the top-left corner of the menu bar.<br>

  <figure><img src="https://2961622933-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqMfOJ12ORoZOYNm0exux%2Fuploads%2FWDmwzuG643LvbiQpO6OL%2Fimage.png?alt=media&amp;token=54ff964e-487a-4a47-951f-6d278da3ab33" alt="" width="563"><figcaption></figcaption></figure>
* Select the \[About This Mac] option.<br>

  <figure><img src="https://2961622933-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqMfOJ12ORoZOYNm0exux%2Fuploads%2FnYA8I7LBi6YEDYO6FyRb%2Fimage.png?alt=media&amp;token=a2031779-aeb9-414c-9053-1a7c69940440" alt="" width="563"><figcaption></figcaption></figure>
* If you see Apple M1(or higher) in the \[Chip] section, it means you’re using a Mac with an Apple Silicon CPU. And you can check your MacOS also.

  <br>

  <figure><img src="https://2961622933-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqMfOJ12ORoZOYNm0exux%2Fuploads%2FuHHMRq9kUAHb2BuW432h%2Fimage.png?alt=media&amp;token=f44b4c6b-5903-4338-984b-6c564a93ecbe" alt="" width="280"><figcaption></figcaption></figure>

#### 2. Download the Correct Docker Version for Apple Chip

<figure><img src="https://2961622933-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqMfOJ12ORoZOYNm0exux%2Fuploads%2FIdWd0cw4cY0Oun0EptQi%2Fimage.png?alt=media&amp;token=97d0d696-0eee-4149-b5ed-f1e485bfeedc" alt=""><figcaption></figcaption></figure>

#### 3. Update to the Latest macOS Sonoma Version

Make sure your macOS Sonoma version is up to date, preferably version 14.4 or later. Do the following steps to check (and update)

* Access <mark style="color:blue;">Setting App</mark> then click "General"

<figure><img src="https://2961622933-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqMfOJ12ORoZOYNm0exux%2Fuploads%2FaRPouHGscxnVugybZ2GR%2Fimage.png?alt=media&amp;token=10f75698-8309-4620-a0ee-ede5920c14db" alt="" width="563"><figcaption></figcaption></figure>

* Click "Software Update" to check

<figure><img src="https://2961622933-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqMfOJ12ORoZOYNm0exux%2Fuploads%2FDCHBPOjcgCymQsARhPSu%2Fimage.png?alt=media&amp;token=dc76c353-903f-47e6-8ba1-41acee7d905a" alt="" width="563"><figcaption></figcaption></figure>

#### 4. Install Rosetta (Not necessary for M3 +)

To check if Rosetta is installed, follow these steps:

* Open Terminal: You can open Terminal from the Applications folder or use Spotlight Search (Press Command + Space and type "Terminal").
* Check Rosetta Version: Enter the following command and press Enter:

  ```bash
  /usr/sbin/sysctl sysctl.proc_translated
  ```

If you receive the output `sysctl.proc_translated: 1`, it means that Rosetta is installed and active on your system. If not, you will either not see any output or the output will be `sysctl.proc_translated: 0`.

<figure><img src="https://2961622933-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqMfOJ12ORoZOYNm0exux%2Fuploads%2FPZzsjKFDINk8jdi3TNCy%2Fimage.png?alt=media&amp;token=4d32760c-88cc-478a-903f-fc4443664a4e" alt=""><figcaption><p>Rosetta isn't installed</p></figcaption></figure>

* If Rosetta is not installed, you can install it by running the following command in Terminal:

```css
softwareupdate --install-rosetta
```

<figure><img src="https://2961622933-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqMfOJ12ORoZOYNm0exux%2Fuploads%2F1FXuyUKEnCjQB9pAh5Id%2Fimage.png?alt=media&amp;token=0a3936c8-0b6e-4ead-82e1-409634062ecb" alt=""><figcaption><p>Installed Rosetta successfully</p></figcaption></figure>

<br>

<br>
