Skip to content

Commit ff1e8e9

Browse files
Add info about installing python3 on Mac, Linux (#6558)
The Mac requires special handholding to allow SSL connections for get.py, so document those for end users.
1 parent 418b00f commit ff1e8e9

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)