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