From 8ff2e01025e45577bb9121645cb2ee90c311141b Mon Sep 17 00:00:00 2001
From: Laverne Henderson <laverne.henderson@coupa.com>
Date: Tue, 23 Aug 2022 10:31:18 -0700
Subject: [PATCH] Update for M1 Mac installations (#14350)

* Update for M1 Mac installations

* Apply suggestions from code review

* Update PL installation

* Update based on feedback

Co-authored-by: Jirka Borovec <Borda@users.noreply.github.com>
---
 docs/source-app/installation.rst              |  2 +-
 docs/source-app/installation_mac.rst          | 22 +++++++++++++++++++
 docs/source-pytorch/starter/installation.rst  |  2 ++
 .../starter/installation_mac.rst              | 22 +++++++++++++++++++
 4 files changed, 47 insertions(+), 1 deletion(-)
 create mode 100644 docs/source-app/installation_mac.rst
 create mode 100644 docs/source-pytorch/starter/installation_mac.rst

diff --git a/docs/source-app/installation.rst b/docs/source-app/installation.rst
index 1828e30cb4..340fd86da8 100644
--- a/docs/source-app/installation.rst
+++ b/docs/source-app/installation.rst
@@ -13,7 +13,7 @@ Don't know what this is? Follow our `beginner guide here <install_beginner.rst>`
 
 * Python 3.8.x or later (3.8.x, 3.9.x, 3.10.x)
 
-Or read the `Windows installation article <installation_win.rst>`_.
+Or read the `Apple Silicon Macs installation article <installation_mac.rst>`_ or the `Windows installation article <installation_win.rst>`_.
 
 ----
 
diff --git a/docs/source-app/installation_mac.rst b/docs/source-app/installation_mac.rst
new file mode 100644
index 0000000000..180a3a8893
--- /dev/null
+++ b/docs/source-app/installation_mac.rst
@@ -0,0 +1,22 @@
+:orphan:
+
+##################################
+Installation on Apple Silicon Macs
+##################################
+
+Apple Silicon (M1, M2, M3) Mac environments need a bit of tweaking before you install.
+
+----
+
+****************
+Install with pip
+****************
+
+Install the ``lightning`` package
+
+    .. code:: bash
+
+        export GRPC_PYTHON_BUILD_SYSTEM_OPENSSL=1
+        export GRPC_PYTHON_BUILD_SYSTEM_ZLIB=1
+
+        pip install lightning
diff --git a/docs/source-pytorch/starter/installation.rst b/docs/source-pytorch/starter/installation.rst
index c5f7760945..6c9fa47c72 100644
--- a/docs/source-pytorch/starter/installation.rst
+++ b/docs/source-pytorch/starter/installation.rst
@@ -19,6 +19,8 @@ Now you can install using `pip <https://pypi.org/project/pytorch-lightning/>`_ u
 
     pip install pytorch-lightning
 
+Or read the `Apple Silicon Macs installation article <installation_mac.rst>`_.
+
 --------------
 
 ******************
diff --git a/docs/source-pytorch/starter/installation_mac.rst b/docs/source-pytorch/starter/installation_mac.rst
new file mode 100644
index 0000000000..180a3a8893
--- /dev/null
+++ b/docs/source-pytorch/starter/installation_mac.rst
@@ -0,0 +1,22 @@
+:orphan:
+
+##################################
+Installation on Apple Silicon Macs
+##################################
+
+Apple Silicon (M1, M2, M3) Mac environments need a bit of tweaking before you install.
+
+----
+
+****************
+Install with pip
+****************
+
+Install the ``lightning`` package
+
+    .. code:: bash
+
+        export GRPC_PYTHON_BUILD_SYSTEM_OPENSSL=1
+        export GRPC_PYTHON_BUILD_SYSTEM_ZLIB=1
+
+        pip install lightning