troubleshooting.rst 816 B

123456789101112131415161718192021
  1. Common Setup Issues
  2. ===================
  3. macOS Issues
  4. ------------
  5. * If you are getting an error message like so: ``Authentication with cloud provider failed: [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed (_ssl.c:749)``
  6. then this indicates that you are probably using a Python distribution on
  7. macOS whose installer ships its own OpenSSL and does not use the system
  8. trusted certificate keychain.
  9. The python.org installer includes a script that installs a bundle of root
  10. certificates from ``certifi``. Run the ``Install Certificates.command``
  11. script bundled with your Python install, for example:
  12. .. code-block:: bash
  13. /Applications/Python\ 3.13/Install\ Certificates.command
  14. For more information see `this StackOverflow
  15. answer <https://stackoverflow.com/a/42583411/1419499>`_.