Skip to content

Commit fadc71f

Browse files
Add info about installing python3 on Mac, Linux
The Mac requires special handholding to allow SSL connections for get.py, so document those for end users.
1 parent 244dbd7 commit fadc71f

File tree

1 file changed

+26
-1
lines changed

1 file changed

+26
-1
lines changed

doc/installing.rst

+26-1
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,7 @@ Prerequisites
1212
- Arduino 1.6.8, get it from `Arduino
1313
website <https://www.arduino.cc/en/Main/OldSoftwareReleases#previous>`__.
1414
- Internet connection
15+
- Python 3 interpreter (Mac/Linux only, Windows installation supplies its own)
1516

1617
Instructions
1718
~~~~~~~~~~~~
@@ -186,9 +187,33 @@ Instructions - Other OS
186187
cd esp8266/tools
187188
python3 get.py
188189
190+
If you get an error message stating that python3 is not found, you will need to install it (most modern UNIX-like OSes provide Python 3 as
191+
part of the default install). To install you will need to use ``sudo yum install python3``, ``sudo apt install python3``, or ``brew install python3``
192+
as appropriate. On the Mac you may get an error message like:
193+
194+
.. code:: bash
195+
196+
python3 get.py
197+
Platform: x86_64-apple-darwin
198+
Downloading python3-macosx-placeholder.tar.gz
199+
Traceback (most recent call last):
200+
File "/Library/Frameworks/Python.framework/Versions/3.7/lib/python3.7/urllib/request.py", line 1317, in do_open
201+
encode_chunked=req.has_header('Transfer-encoding'))
202+
...
203+
File "/Library/Frameworks/Python.framework/Versions/3.7/lib/python3.7/ssl.py", line 1117, in do_handshake
204+
self._sslobj.do_handshake()
205+
ssl.SSLCertVerificationError: [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate (_ssl.c:1056)
206+
207+
This is because Homebrew on the Mac does not always install the required SSL certificates by default. Install them manually (adjust the Python 3.7 as needed) with:
208+
209+
.. code:: bash
210+
211+
cd "/Applications/Python 3.7/" && sudo "./Install Certificates.command"
212+
213+
189214
- Restart Arduino
190215
191-
- When later updating your local library, goto the esp8266 directory and do a git pull
216+
- When later updating your local library, goto the esp8266 directory and do a git pull
192217
193218
.. code:: bash
194219

0 commit comments

Comments
 (0)