diff --git a/packaging/language/composer.py b/packaging/language/composer.py
index d5e6467e9c5..4c5f8518bee 100644
--- a/packaging/language/composer.py
+++ b/packaging/language/composer.py
@@ -103,6 +103,7 @@ requirements:
     - composer installed in bin path (recommended /usr/local/bin)
 notes:
     - Default options that are always appended in each execution are --no-ansi, --no-interaction and --no-progress if available.
+    - We received reports about issues on macOS if composer was installed by Homebrew. Please use the official install method to avoid it.
 '''
 
 EXAMPLES = '''