diff --git a/docs/source-app/index.rst b/docs/source-app/index.rst
index 55b1ac79d0..8bbe84702c 100644
--- a/docs/source-app/index.rst
+++ b/docs/source-app/index.rst
@@ -27,7 +27,7 @@ Install Lightning
 
 .. code-block:: bash
 
-   pip install lightning
+   python -m pip install -U lightning
 
 
 Or read the :ref:`advanced install <install>` guide.
diff --git a/docs/source-app/installation.rst b/docs/source-app/installation.rst
index 340fd86da8..0faa50216e 100644
--- a/docs/source-app/installation.rst
+++ b/docs/source-app/installation.rst
@@ -28,3 +28,11 @@ Install with pip
     .. code:: bash
 
         python -m pip install -U lightning
+
+.. note::
+
+    If you encounter issues during installation use the following to help troubleshoot:
+
+	.. code:: bash
+
+            pip list | grep lightning
diff --git a/docs/source-app/installation_mac.rst b/docs/source-app/installation_mac.rst
index 180a3a8893..d6274be24f 100644
--- a/docs/source-app/installation_mac.rst
+++ b/docs/source-app/installation_mac.rst
@@ -19,4 +19,4 @@ Install the ``lightning`` package
         export GRPC_PYTHON_BUILD_SYSTEM_OPENSSL=1
         export GRPC_PYTHON_BUILD_SYSTEM_ZLIB=1
 
-        pip install lightning
+        python -m pip install -U lightning