diff --git a/docs/installation/osx.rst b/docs/installation/osx.rst
index f8583084..bedadba2 100644
--- a/docs/installation/osx.rst
+++ b/docs/installation/osx.rst
@@ -9,9 +9,6 @@ If you are running OS X, you can install everything needed with Homebrew.
xcode-select --install
-#. Install `XQuartz `_. This is needed by
- GStreamer which Mopidy use heavily.
-
#. Install `Homebrew `_.
#. If you are already using Homebrew, make sure your installation is up to
@@ -52,6 +49,18 @@ If you are running OS X, you can install everything needed with Homebrew.
brew tap mopidy/mopidy
+ .. note::
+
+ Mopidy currently requires that a few of its dependencies be built with
+ Python 2 support via the ``--with-python@2`` build option. To ensure
+ that this is done for your installation, it is recommended to
+ uninstall the dependencies first with::
+
+ brew uninstall --ignore-dependencies gst-python pygobject3
+
+ These dependencies will be re-installed automatically when Mopidy is
+ installed.
+
#. To install Mopidy, run::
brew install mopidy