> For the complete documentation index, see [llms.txt](https://docs.oxygenhq.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.oxygenhq.org/download-installation-start/download-and-installation/oxygen-for-mac-installation/troubleshooting-installation-issues-mac.md).

# Mac Installation Troubleshooting

Installing Xcode on Mac. Troubleshooting Xcode issues.

Installation of Oxygen IDE on Mac, for example on OS 10.15 Catalina, has a dependency on installing Apple's software development IDE which called Xcode from the Apple Mac App Store.

<img src="https://3998735799-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lwyvw09Dn_2O4RFZKxE%2F-M4Xq_LIroLEIlR8MW1z%2F-M4XsMRDTK2V4pcolN8d%2Fapp-store-xcode-install-button-1024x765.png?alt=media&amp;token=91026688-2e8e-4971-a93d-a519520cb8f3" alt="" data-size="original">&#x20;

Xcode is available to download for free from the Mac App Store with an Apple Developer account. If Xcode is not already installed or configured correctly, the user will receive a "Device Discover Service" warning message when launching Oxygen IDE with the text: "Could not find the instruments binary. Please ensure 'xcrun -find instruments' can locate it.

<img src="https://3998735799-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lwyvw09Dn_2O4RFZKxE%2F-M4Xq_LIroLEIlR8MW1z%2F-M4XresMxpDhe5eT1B9O%2FDevice%20Discovery%20Service%20-%20xcrun%20-find%20instruments.png?alt=media&amp;token=5b4897c5-c182-4f3a-8ff9-36a3166bc4ac" alt="" data-size="original">&#x20;

NB: If you are a corporate user using a corporate machine, your organization may require that you download and install Xcode from your company's self-service portal for software installation packages.

Downloading applications from the Mac App Store requires having your Apple ID set-up and entered. The following link goes through a step-by-step process for installing Xcode on Mac OS:&#x20;

<https://www.codingpursuits.com/how-to-download-and-install-xcode-11-on-macos-catalina/>

If you continue to receive the Device Discovery Service error mentioned above and in the screenshot, try the process described here: You need to launch XCode and agree to the terms first, if this is your first time using a new installation. Then, go to: `Preferences > Locations` and you'll see a selection drop down for **Command Line Tools**. Click this select box and choose the version of XCode you'll be using.&#x20;

This should resolve the issue.

![Set the location of the Xcode Command Line Tools for the correct Xcode installation](https://3998735799-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lwyvw09Dn_2O4RFZKxE%2F-M4Xgulo-Ja-60WA2qHL%2F-M4XmaFC2XToafVnF3mc%2FSet%20Location%20Path%20Xcode%20Developer%20Command%20Line%20Tools.png?alt=media\&token=fdf98234-8813-48c1-b8c0-f43a3fca0e3f)

{% embed url="<http://www.seanbehan.com/how-to-fix-xcrun-error-unable-to-find-utility-instruments-not-a-developer-tool-or-in-path/>" %}

Additionally, in order to use the automatic script recording tool in Mac OS X, you must manually install and enable the Oxygen Extension for Chrome browser on Mac.

[Install Oxygen Chrome Extension](https://chrome.google.com/webstore/detail/oxygen/ibbmgejonlmocgjnkmabigdgbolcomea)