.. _mac-setup-alts: macOS alternative setup instructions #################################### .. _mac-gatekeeper: Important note about Gatekeeper ******************************* Starting with macOS 10.15 Catalina, applications launched from the macOS Terminal application (or any other terminal emulator) are subject to the same system security policies that are applied to applications launched from the Dock. This means that if you download executable binaries using a web browser, macOS will not let you execute those from the Terminal by default. In order to get around this issue you can take two different approaches: * Run ``xattr -r -d com.apple.quarantine /path/to/folder`` where ``path/to/folder`` is the path to the enclosing folder where the executables you want to run are located. * Open :menuselection:`System Preferences --> Security and Privacy --> Privacy` and then scroll down to "Developer Tools". Then unlock the lock to be able to make changes and check the checkbox corresponding to your terminal emulator of choice. This will apply to any executable being launched from such terminal program. Note that this section does **not** apply to executables installed with Homebrew, since those are automatically un-quarantined by ``brew`` itself. This is however relevant for most :ref:`toolchains`. .. _macOS Gatekeeper: https://en.wikipedia.org/wiki/Gatekeeper_(macOS) Additional notes for MacPorts users *********************************** While MacPorts is not officially supported in this guide, it is possible to use MacPorts instead of Homebrew to get all the required dependencies on macOS. Note also that you may need to install ``rust`` and ``cargo`` for the Python dependencies to install correctly.