MacOS: Trouble setting up dev environment #23758

geri-m · 2025-08-04T05:10:03Z

geri-m
Aug 4, 2025

I'd like to compile Tasmota locally (Macbook Air, Apple Silicon, M2), but I have trouble getting the setup run. What I tried:

(1) Stand Alone PlatformIO Installation

Local Visual Studio Code Install (Latest) + Lated Platform IO IDE Extension installed. (successfully)

Debugging information is available via VSCode > Help > Toggle Developer Tools > Console.
PlatformIO IDE installed successfully.

Create a Sample Project. Build Command in VS Code works.
Clone Tasmota Repo
Open Project in VS Code + Open via Platoform IO Dialog
The (first) Log on opening the project looks like this

Resolving tasmota dependencies...
Platform Manager: Installing https://github.com/tasmota/platform-espressif8266/releases/download/2025.07.00/platform-espressif8266.zip
Downloading 0% 10% 20% 30% 40% 50% 60% 70% 80%
Unpacking 0% 10% 20% 30% 40% 50% 60% 70% 80% 90% 100%
Platform Manager: espressif8266@2025.7.0 has been installed!
Tool Manager: Installing https://github.com/pioarduino/registry/releases/download/0.0.1/xtensa-4.8.2.zip
Downloading 0% 10%
Unpacking 0% 10% 20%
Tool Manager: toolchain-xtensa@2.40802.200502 has been installed!
Tool Manager: Installing https://github.com/tasmota/Arduino/releases/download/2.7.8/esp8266-2.7.8.zip
Downloading 0% 10% 20% 30% 40% 50% 60% 70% 80% 90% 100%
Unpacking 0% 10% 20% 30% 40% 50% 60% 70% 80% 90% 100%
Tool Manager: framework-arduinoespressif8266@2.7.8 has been installed!
Tool Manager: Installing https://github.com/pioarduino/esp_install/releases/download/v5.1.0/esp_install-v5.1.0.zip
Downloading 0% 10% 20% 30% 40% 50% 60%
Unpacking 0% 10% 20% 30% 40% 50% 60% 70% 80% 90% 100%
Tool Manager: tl-install@5.1.0 has been installed!
Tool Manager: Installing https://github.com/pioarduino/registry/releases/download/0.0.1/mklittlefs-2.3.0.zip
Downloading 0% 10%
Unpacking 0% 10% 20%
Tool Manager: tool-mklittlefs@1.203.210628 has been installed!
Updating metadata for the vscode IDE...
UserSideException: Processing tasmota (platform: https://github.com/tasmota/platform-espressif8266/releases/download/2025.07.00/platform-espressif8266.zip; framework: arduino; board: esp8266_1M)
--------------------------------------------------------------------------------
Error: Couldn't execute 'idf_tools.py install'
Error: Couldn't execute 'idf_tools.py install'
Error: Couldn't execute 'idf_tools.py install'
Error: Couldn't execute 'idf_tools.py install'
Verbose mode can be enabled via `-v, --verbose` option
Error: Couldn't execute 'idf_tools.py install'
Error: Couldn't execute 'idf_tools.py install'
-DCONFIG_TASMOTA_FLASHMODE_DOUT
*** use provided user_config_override.h as planned ***
*** use provided platformio_override.ini as planned ***
*** use provided platformio_tasmota_cenv.ini as planned ***
PIO called from VS Code extension
OS Platform: Darwin
CONFIGURATION: https://docs.platformio.org/page/boards/espressif8266/esp8266_1M.html
PLATFORM: Espressif 8266 (2025.7.0) > Espressif Generic ESP8266 Tasmota 1M sketch NO FS
HARDWARE: ESP8266 80MHz, 80KB RAM, 972.00KB Flash
PACKAGES: 
 - framework-arduinoespressif8266 @ 2.7.8 
 - tool-mklittlefs @ 1.203.210628 (2.3) 
 - toolchain-xtensa @ 2.40802.200502 (4.8.2)
Converting tasmota.ino
sh: xtensa-lx106-elf-g++: command not found
*** Error 127
AssertionError: :
  File "/Users/xxx/.platformio/penv/lib/python3.11/site-packages/platformio/builder/main.py", line 173:
    env.SConscript("$BUILD_SCRIPT")
  File "/Users/xxx/.platformio/packages/tool-scons/scons-local-4.8.1/SCons/Script/SConscript.py", line 620:
    return _SConscript(self.fs, *files, **subst_kw)
  File "/Users/xxx/.platformio/packages/tool-scons/scons-local-4.8.1/SCons/Script/SConscript.py", line 280:
    exec(compile(scriptdata, scriptname, 'exec'), call_stack[-1].globals)
  File "/Users/xxx/.platformio/platforms/espressif8266/builder/main.py", line 271:
    target_elf = env.BuildProgram()
  File "/Users/xxx/.platformio/packages/tool-scons/scons-local-4.8.1/SCons/Util/envs.py", line 252:
    return self.method(*nargs, **kwargs)
  File "/Users/xxx/.platformio/penv/lib/python3.11/site-packages/platformio/builder/tools/piobuild.py", line 62:
    env.ProcessProgramDeps()
  File "/Users/xxx/.platformio/packages/tool-scons/scons-local-4.8.1/SCons/Util/envs.py", line 252:
    return self.method(*nargs, **kwargs)
  File "/Users/xxx/.platformio/penv/lib/python3.11/site-packages/platformio/builder/tools/piobuild.py", line 142:
    env.BuildFrameworks(env.get("PIOFRAMEWORK"))
  File "/Users/xxx/.platformio/packages/tool-scons/scons-local-4.8.1/SCons/Util/envs.py", line 252:
    return self.method(*nargs, **kwargs)
  File "/Users/xxx/.platformio/penv/lib/python3.11/site-packages/platformio/builder/tools/piobuild.py", line 349:
    env.ConvertInoToCpp()
  File "/Users/xxx/.platformio/packages/tool-scons/scons-local-4.8.1/SCons/Util/envs.py", line 252:
    return self.method(*nargs, **kwargs)
  File "/Users/xxx/.platformio/penv/lib/python3.11/site-packages/platformio/builder/tools/pioino.py", line 237:
    out_file = c.convert(ino_nodes)
  File "/Users/xxx/.platformio/penv/lib/python3.11/site-packages/platformio/builder/tools/pioino.py", line 85:
    return self.process(contents)
  File "/Users/xxx/.platformio/penv/lib/python3.11/site-packages/platformio/builder/tools/pioino.py", line 106:
    assert self._gcc_preprocess(contents, out_file)
========================== [FAILED] Took 2.25 seconds ==========================

Environment    Status    Duration
-------------  --------  ------------
tasmota        FAILED    00:00:02.253
==================== 1 failed, 0 succeeded in 00:00:02.253 ====================

(2) GitPod Setup

Use full local setup. (Gitpod local runner, Local VS Code Install; no [!] Platform IO Extension in VS Code)
Open Repo via GitPod
On the Visual Studio Code Terminal (in the GitPod Container) I don't have the command platformio to compile code.

vscode ➜ /workspaces/Tasmota (development) $ platformio
bash: platformio: command not found

I was under the assumption that GitPod would manage the required tools in the container itself, therefore I did not investiage further how to add tools.

If there is any further information I can help with to get this resolved, let me know.

Jason2866 · 2025-08-04T13:27:14Z

Jason2866
Aug 4, 2025
Collaborator

Close VSC. Delete anything in folder .platformio Only keep the folder penv Start VSC and follow instructions. Try to compile or better change the setup that it compiles first tasmota32

1 reply

geri-m Aug 4, 2025
Author

Thanks for the response.

What I did

Removed content from .platformio folder, but not penv
Started VSC
Waited until platformIO stuff was installed
Restarted VSC
Changed in platformio_override.ini the default_envs from tasmota to tasmota32.
Waited until platformIO stuff was installed (-> idf-tools.py failed to install)
Closed VSC
Tried to build again (-> idf-tools.py failed to install)
Closed VSC
Removed content from .platformio folder, but not penv
Started VSC
Waited until platformIO stuff was installed
Build still gives me an error

 *  Executing task: platformio run 

Processing tasmota32 (framework: arduino; platform: https://github.com/tasmota/platform-espressif32/releases/download/2025.07.31/platform-espressif32.zip; board: esp32)
------------------------------------------------------------------------------------------------------------------------------------------------
idf_tools.py installation failed
idf_tools.py installation failed
idf_tools.py installation failed
idf_tools.py installation failed
idf_tools.py installation failed
idf_tools.py installation failed
Verbose mode can be enabled via `-v, --verbose` option
idf_tools.py installation failed
idf_tools.py installation failed
idf_tools.py installation failed
Nothing more to solidify
-DCONFIG_TASMOTA_FLASHMODE_DIO
*** use provided user_config_override.h as planned ***
*** use provided platformio_override.ini as planned ***
*** use provided platformio_tasmota_cenv.ini as planned ***
PIO called from VS Code extension
OS Platform: Darwin
error: /Users/xxx/.platformio/packages/tool-esptoolpy does not appear to be a Python project, as neither `pyproject.toml` nor `setup.py` are present in the directory
Warning: Failed to install esptool: Command '['/Users/xxx/.platformio/penv/bin/uv', 'pip', 'install', '--quiet', '--python=/Users/xxx/.platformio/penv/bin/python', '-e', '/Users/xxx/.platformio/packages/tool-esptoolpy']' returned non-zero exit status 2.
CONFIGURATION: https://docs.platformio.org/page/boards/espressif32/esp32.html
PLATFORM: Espressif 32 (2025.7.31) > Espressif Generic ESP32 >= 4M Flash PSRAM, Tasmota 2880k Code/OTA, 320k FS
HARDWARE: ESP32 160MHz, 320KB RAM, 4MB Flash
DEBUG: Current (cmsis-dap) External (cmsis-dap, esp-bridge, esp-prog, iot-bus-jtag, jlink, minimodule, olimex-arm-usb-ocd, olimex-arm-usb-ocd-h, olimex-arm-usb-tiny-h, olimex-jtag-tiny, tumpa)
PACKAGES: 
 - contrib-piohome @ 3.4.4 
 - framework-arduinoespressif32 @ 3.1.3+sha.a0094062 
 - tool-esptoolpy @ 5.0.1 
 - tool-mklittlefs @ 3.2.0 
 - toolchain-xtensa-esp-elf @ 13.2.0+20240530
Converting tasmota.ino
sh: xtensa-esp32-elf-g++: command not found
*** Error 127
AssertionError: :
  File "/Users/xxx/.platformio/penv/lib/python3.11/site-packages/platformio/builder/main.py", line 173:
    env.SConscript("$BUILD_SCRIPT")
  File "/Users/xxx/.platformio/packages/tool-scons/scons-local-4.8.1/SCons/Script/SConscript.py", line 620:
    return _SConscript(self.fs, *files, **subst_kw)
  File "/Users/xxx/.platformio/packages/tool-scons/scons-local-4.8.1/SCons/Script/SConscript.py", line 280:
    exec(compile(scriptdata, scriptname, 'exec'), call_stack[-1].globals)
  File "/Users/xxx/.platformio/platforms/espressif32/builder/main.py", line 958:
    target_elf = env.BuildProgram()
  File "/Users/xxx/.platformio/packages/tool-scons/scons-local-4.8.1/SCons/Util/envs.py", line 252:
    return self.method(*nargs, **kwargs)
  File "/Users/xxx/.platformio/penv/lib/python3.11/site-packages/platformio/builder/tools/piobuild.py", line 62:
    env.ProcessProgramDeps()
  File "/Users/xxx/.platformio/packages/tool-scons/scons-local-4.8.1/SCons/Util/envs.py", line 252:
    return self.method(*nargs, **kwargs)
  File "/Users/xxx/.platformio/penv/lib/python3.11/site-packages/platformio/builder/tools/piobuild.py", line 142:
    env.BuildFrameworks(env.get("PIOFRAMEWORK"))
  File "/Users/xxx/.platformio/packages/tool-scons/scons-local-4.8.1/SCons/Util/envs.py", line 252:
    return self.method(*nargs, **kwargs)
  File "/Users/xxx/.platformio/penv/lib/python3.11/site-packages/platformio/builder/tools/piobuild.py", line 349:
    env.ConvertInoToCpp()
  File "/Users/xxx/.platformio/packages/tool-scons/scons-local-4.8.1/SCons/Util/envs.py", line 252:
    return self.method(*nargs, **kwargs)
  File "/Users/xxx/.platformio/penv/lib/python3.11/site-packages/platformio/builder/tools/pioino.py", line 237:
    out_file = c.convert(ino_nodes)
  File "/Users/xxx/.platformio/penv/lib/python3.11/site-packages/platformio/builder/tools/pioino.py", line 85:
    return self.process(contents)
  File "/Users/xxx/.platformio/penv/lib/python3.11/site-packages/platformio/builder/tools/pioino.py", line 106:
    assert self._gcc_preprocess(contents, out_file)
========================================================== [FAILED] Took 3.51 seconds ==========================================================

Environment    Status    Duration
-------------  --------  ------------
tasmota32      FAILED    00:00:03.511
==================================================== 1 failed, 0 succeeded in 00:00:03.511 ====================================================

 *  The terminal process "platformio 'run'" terminated with exit code: 1. 
 *  Terminal will be reused by tasks, press any key to close it.

Any more ideas?

Jason2866 · 2025-08-04T17:40:13Z

Jason2866
Aug 4, 2025
Collaborator

The installer downloads tar packages compressed with lzma. If the preinstalled Apple Python is used there is no support for. Install brew and install Python via brew. If this is done install the xz (=lzma) support package for tar.

Make sure the idf var IDF_TOOLS_PATH is not set anywhere in your path!

The needed python env seems correctly installed since in the logs the folder penv appears in the path. So a lot is already working.

1 reply

geri-m Aug 4, 2025
Author

Thanks for the help so far

I have Python3 and xz installed via brew. (check via which; was actually the case before; I'm not sure, if this is even used, as there is portable Python Version part of platformIO). Anyways.

To fix the issue

error: /Users/madlmayr/.platformio/packages/tool-esptoolpy does not appear to be a Python project, as neither `pyproject.toml` nor `setup.py` are present in the directory

I "manually" installed this package via

 ./uv pip install --python=/Users/madlmayr/.platformio/penv/bin/python tool-esptoolpy

from the terminal.

Build still fails.

Processing tasmota32 (framework: arduino; platform: https://github.com/tasmota/platform-espressif32/releases/download/2025.07.31/platform-espressif32.zip; board: esp32)
-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
idf_tools.py installation failed
idf_tools.py installation failed
idf_tools.py installation failed
idf_tools.py installation failed
idf_tools.py installation failed
idf_tools.py installation failed
Verbose mode can be enabled via `-v, --verbose` option
idf_tools.py installation failed
idf_tools.py installation failed
idf_tools.py installation failed
Nothing more to solidify
-DCONFIG_TASMOTA_FLASHMODE_DIO
*** use provided user_config_override.h as planned ***
*** use provided platformio_override.ini as planned ***
*** use provided platformio_tasmota_cenv.ini as planned ***
PIO called from VS Code extension
OS Platform: Darwin
CONFIGURATION: https://docs.platformio.org/page/boards/espressif32/esp32.html
PLATFORM: Espressif 32 (2025.7.31) > Espressif Generic ESP32 >= 4M Flash PSRAM, Tasmota 2880k Code/OTA, 320k FS
HARDWARE: ESP32 160MHz, 320KB RAM, 4MB Flash
DEBUG: Current (cmsis-dap) External (cmsis-dap, esp-bridge, esp-prog, iot-bus-jtag, jlink, minimodule, olimex-arm-usb-ocd, olimex-arm-usb-ocd-h, olimex-arm-usb-tiny-h, olimex-jtag-tiny, tumpa)
PACKAGES: 
 - contrib-piohome @ 3.4.4 
 - framework-arduinoespressif32 @ 3.1.3+sha.a0094062 
 - tool-esptoolpy @ 5.0.1 
 - tool-mklittlefs @ 3.2.0 
 - toolchain-xtensa-esp-elf @ 13.2.0+20240530
Converting tasmota.ino
sh: xtensa-esp32-elf-g++: command not found
*** Error 127
AssertionError: :
  File "/Users/xxx/.platformio/penv/lib/python3.11/site-packages/platformio/builder/main.py", line 173:
    env.SConscript("$BUILD_SCRIPT")
  File "/Users/xxx/.platformio/packages/tool-scons/scons-local-4.8.1/SCons/Script/SConscript.py", line 620:
    return _SConscript(self.fs, *files, **subst_kw)
  File "/Users/xxx/.platformio/packages/tool-scons/scons-local-4.8.1/SCons/Script/SConscript.py", line 280:
    exec(compile(scriptdata, scriptname, 'exec'), call_stack[-1].globals)
  File "/Users/xxx/.platformio/platforms/espressif32/builder/main.py", line 958:
    target_elf = env.BuildProgram()
  File "/Users/xxx/.platformio/packages/tool-scons/scons-local-4.8.1/SCons/Util/envs.py", line 252:
    return self.method(*nargs, **kwargs)
  File "/Users/xxx/.platformio/penv/lib/python3.11/site-packages/platformio/builder/tools/piobuild.py", line 62:
    env.ProcessProgramDeps()
  File "/Users/xxx/.platformio/packages/tool-scons/scons-local-4.8.1/SCons/Util/envs.py", line 252:
    return self.method(*nargs, **kwargs)
  File "/Users/xxx/.platformio/penv/lib/python3.11/site-packages/platformio/builder/tools/piobuild.py", line 142:
    env.BuildFrameworks(env.get("PIOFRAMEWORK"))
  File "/Users/xxx/.platformio/packages/tool-scons/scons-local-4.8.1/SCons/Util/envs.py", line 252:
    return self.method(*nargs, **kwargs)
  File "/Users/xxx/.platformio/penv/lib/python3.11/site-packages/platformio/builder/tools/piobuild.py", line 349:
    env.ConvertInoToCpp()
  File "/Users/xxx/.platformio/packages/tool-scons/scons-local-4.8.1/SCons/Util/envs.py", line 252:
    return self.method(*nargs, **kwargs)
  File "/Users/xxx/.platformio/penv/lib/python3.11/site-packages/platformio/builder/tools/pioino.py", line 237:
    out_file = c.convert(ino_nodes)
  File "/Users/xxx/.platformio/penv/lib/python3.11/site-packages/platformio/builder/tools/pioino.py", line 85:
    return self.process(contents)
  File "/Users/xxx/.platformio/penv/lib/python3.11/site-packages/platformio/builder/tools/pioino.py", line 106:
    assert self._gcc_preprocess(contents, out_file)
=========================================================================================================================== [FAILED] Took 4.50 seconds ===========================================================================================================================

Environment    Status    Duration
-------------  --------  ------------
tasmota32      FAILED    00:00:04.495

I was unable to resolve sh: xtensa-esp32-elf-g++: command not found and the Error 127. How much do I have to worry about the idf_tools.py installation failed?

Jason2866 · 2025-08-04T20:26:53Z

Jason2866
Aug 4, 2025
Collaborator

The problem is the not working installer (idf_tools.py) all errors you encounter are caused from that
Do you have folders dist and tools in .platformio?

3 replies

geri-m Aug 5, 2025
Author

Yes, I have a dist folder (which is empty) but no tools folder.

Jason2866 Aug 5, 2025
Collaborator

The installer fails completely. Please read this https://docs.espressif.com/projects/esp-idf/en/stable/esp32/get-started/linux-macos-setup.html#get-started-prerequisites and try to install the tools (Step 3. Set up the Tools). Reason the installer under the hood is the espressif installer (minimal modified). If you encounter errors here, you need to solve the probably certificate issues.

In every case do NOT set the IDF_TOOLS_PATH !!

Jason2866 Aug 5, 2025
Collaborator

Mac-Zertifikatsprobleme bei Downloads - Analyse und Lösungen

Häufige Gründe für Zertifikatsprobleme auf macOS:

1. Veraltete Python-Zertifikate

Python verwendet das certifi-Paket für SSL-Zertifikate
Diese können veraltet sein, besonders bei älteren Python-Installationen
Lösung: python3 -m pip install --upgrade certifi

2. macOS System-Python (/usr/bin/python3) Probleme

Apple's Standard-Python nutzt System-Zertifikate aus dem Keychain
System-Updates können manchmal Zertifikate beschädigen
Lösung: System-Zertifikate exportieren und als SSL_CERT_FILE setzen

3. macOS Keychain-Probleme

macOS verwaltet Zertifikate über den Keychain
System-Updates können manchmal Zertifikate beschädigen
Lösung: Keychain Access → Certificate Assistant → Evaluate

4. Python.org Zertifikate nicht installiert

Bei Python.org Installationen werden Zertifikate oft nicht automatisch installiert
Lösung: /Applications/Python\ 3.x/Install\ Certificates.command ausführen

5. Corporate/Proxy-Umgebung

Firmen-Proxies mit eigenen Zertifikaten
Lösung: Corporate CA-Zertifikate zum Python-Store hinzufügen

Standard macOS Python (/usr/bin/python3) Lösungen:

# 1. System-Zertifikate exportieren
security find-certificate -a -p /System/Library/Keychains/SystemRootCertificates.keychain > /tmp/system_certs.pem

# 2. Environment Variable setzen
export SSL_CERT_FILE=/tmp/system_certs.pem

# 3. Python certifi für System-Python aktualisieren
/usr/bin/python3 -m pip install --user --upgrade certifi

# 4. System aktualisieren
# System Settings → General → Software Update

# 5. Test der Verbindung
curl -v https://dl.espressif.com

Homebrew Python Lösungen:

# Homebrew CA-Zertifikate installieren
brew install ca-certificates

# Python certifi über Homebrew aktualisieren
brew reinstall python-certifi

# Homebrew Python testen
/opt/homebrew/bin/python3 -c "import ssl; print(ssl.get_default_verify_paths())"

Python.org Installation Lösungen:

# Install Certificates Command ausführen (falls verfügbar)
/Applications/Python\ 3.11/Install\ Certificates.command
# oder
/Applications/Python\ 3.12/Install\ Certificates.command

# Certifi manuell aktualisieren
python3 -m pip install --upgrade certifi

Zertifikate aktualisieren

python3 -m pip install --upgrade certifi

Python.app Zertifikate installieren (falls verfügbar)

/Applications/Python\ 3.*/Install\ Certificates.command

Homebrew CA-Zertifikate

brew install ca-certificates

Test einer HTTPS-Verbindung

python3 -c "import urllib.request; urllib.request.urlopen('https://dl.espressif.com')"

Weitere Lösungsansätze:

Environment Variables setzen:

export SSL_CERT_FILE=$(python3 -m certifi)
export REQUESTS_CA_BUNDLE=$(python3 -m certifi)

Firmen-Proxy umgehen:

export https_proxy=""
export HTTPS_PROXY=""

Zertifikat manuell herunterladen:

# DigiCert Root CA manuell hinzufügen
curl -O https://cacerts.digicert.com/DigiCertGlobalRootG2.crt

Jason2866 · 2025-08-05T15:58:26Z

Jason2866
Aug 5, 2025
Collaborator

macOS Certificate Issues in Python Downloads - Analysis and Solutions

Common Causes of Certificate Problems on macOS:

1. Outdated Python Certificates

Python uses the certifi package for SSL certificates
These can become outdated, especially with older Python installations
Solution: python3 -m pip install --upgrade certifi

2. macOS System Python (/usr/bin/python3) Issues

Apple's standard Python uses system certificates from the Keychain
System updates can sometimes damage certificates
Solution: Export system certificates and set as SSL_CERT_FILE

3. macOS Keychain Problems

macOS manages certificates through the Keychain
System updates can sometimes corrupt certificates
Solution: Keychain Access → Certificate Assistant → Evaluate

4. Python.org Certificates Not Installed

With Python.org installations, certificates are often not installed automatically
Solution: Run /Applications/Python\ 3.x/Install\ Certificates.command

5. Corporate/Proxy Environment

Corporate proxies with their own certificates
Solution: Add corporate CA certificates to Python certificate store

Standard macOS Python (/usr/bin/python3) Solutions:

# 1. Export system certificates
security find-certificate -a -p /System/Library/Keychains/SystemRootCertificates.keychain > /tmp/system_certs.pem

# 2. Set environment variable
export SSL_CERT_FILE=/tmp/system_certs.pem

# 3. Update Python certifi for system Python
/usr/bin/python3 -m pip install --user --upgrade certifi

# 4. Update the system
# System Settings → General → Software Update

# 5. Test connection
curl -v https://dl.espressif.com

Homebrew Python Solutions:

# Install Homebrew CA certificates
brew install ca-certificates

# Install OpenSSL
brew install openssl

# Update Python certifi via Homebrew
brew reinstall python-certifi

# Test Homebrew Python
/opt/homebrew/bin/python3 -c "import ssl; print(ssl.get_default_verify_paths())"

Python.org Installation Solutions:

# Run Install Certificates Command (if available)
/Applications/Python\ 3.11/Install\ Certificates.command
# or
/Applications/Python\ 3.12/Install\ Certificates.command

# Manually update certifi
python3 -m pip install --upgrade certifi

Debugging Commands for macOS:

# Display Python SSL information
python3 -c "import ssl, certifi; print('SSL:', ssl.OPENSSL_VERSION); print('Certifi:', certifi.where())"

# Update certificates
python3 -m pip install --upgrade certifi

# Install Python.app certificates (if available)
/Applications/Python\ 3.*/Install\ Certificates.command

# Homebrew CA certificates
brew install ca-certificates

# Test HTTPS connection
python3 -c "import urllib.request; urllib.request.urlopen('https://dl.espressif.com')"

Additional Solution Approaches:

Set Environment Variables:

export SSL_CERT_FILE=$(python3 -m certifi)
export REQUESTS_CA_BUNDLE=$(python3 -m certifi)

Bypass Corporate Proxy:

export https_proxy=""
export HTTPS_PROXY=""

Manually Download Certificates:

# Manually add DigiCert Root CA
curl -O https://cacerts.digicert.com/DigiCertGlobalRootG2.crt

Reset Certificate Cache:

# Clear pip and certificate caches
sudo rm -rf /tmp/pip-* && rm -rf ~/.cache/pip

Python Installation Type Detection:

Different Python installations on macOS require different approaches:

System Python (/usr/bin/python3):

Uses macOS system certificates
Requires system certificate export
Best approach: Extract system certificates and set SSL_CERT_FILE

Homebrew Python (/opt/homebrew or /usr/local):

Uses Homebrew-managed certificates
Best approach: Update via brew install ca-certificates

Python.org Installation (/Applications/Python):

Often missing certificates initially
Best approach: Run Install Certificates.command script

Testing Your Solution:

# Test 1: Basic SSL connection
python3 -c "import ssl; ssl.create_default_context().check_hostname = True"

# Test 2: Download test
python3 -c "import urllib.request; print('Success:', urllib.request.urlopen('https://dl.espressif.com').status)"

# Test 3: Certificate path verification
python3 -c "import certifi; print('Certifi path:', certifi.where())"

# Test 4: System certificate access
security find-certificate -a -p /System/Library/Keychains/SystemRootCertificates.keychain | head -20

2 replies

Jason2866 Aug 5, 2025
Collaborator

@geri-m The mentioned brew solution(s) should solve the problem

geri-m Aug 5, 2025
Author

Thanks for the pointers. If I now use idf.py build I come along come compilation errors, which I need to look into. I'm currently consdering heading for a linux environment, simple to overcome the setup issues. I'll keep you posted.

Jason2866 · 2025-08-05T19:57:22Z

Jason2866
Aug 5, 2025
Collaborator

No really not needed. I do all development on a Macbook Air M1. You can try

https://github.com/Jason2866/platform-espressif32.git#Arduino/IDF53

I have added a option in the installer to fall back to not verified https when the cert secured attempt failed.
It is still safe it is https but just not verified.

@geri-m If the above installer still fails try with a simple example project this one:

https://github.com/pioarduino/platform-espressif32.git#dl_urllib

i have rewritten the download routine to use the Python lib urllib with Mac environment detection which ssl variant is supported. Since this a major rewrite i will only switch to this version if the above 1st version with fallback strategy fails.

EDIT: If one of the two versions solves the installer problems, i will do a Tasmota Platform release with the change.

0 replies

MacOS: Trouble setting up dev environment #23758

Uh oh!

geri-m Aug 4, 2025

(1) Stand Alone PlatformIO Installation

(2) GitPod Setup

Replies: 5 comments · 7 replies

Uh oh!

Jason2866 Aug 4, 2025 Collaborator

Uh oh!

geri-m Aug 4, 2025 Author

Uh oh!

Uh oh!

Jason2866 Aug 4, 2025 Collaborator

Uh oh!

geri-m Aug 4, 2025 Author

Uh oh!

Uh oh!

Jason2866 Aug 4, 2025 Collaborator

Uh oh!

geri-m Aug 5, 2025 Author

Uh oh!

Uh oh!

Jason2866 Aug 5, 2025 Collaborator

Uh oh!

Uh oh!

Jason2866 Aug 5, 2025 Collaborator

Mac-Zertifikatsprobleme bei Downloads - Analyse und Lösungen

Häufige Gründe für Zertifikatsprobleme auf macOS:

1. Veraltete Python-Zertifikate

2. macOS System-Python (/usr/bin/python3) Probleme

3. macOS Keychain-Probleme

4. Python.org Zertifikate nicht installiert

5. Corporate/Proxy-Umgebung

Standard macOS Python (/usr/bin/python3) Lösungen:

Homebrew Python Lösungen:

Python.org Installation Lösungen:

Zertifikate aktualisieren

Python.app Zertifikate installieren (falls verfügbar)

Homebrew CA-Zertifikate

Test einer HTTPS-Verbindung

Weitere Lösungsansätze:

Environment Variables setzen:

Firmen-Proxy umgehen:

Zertifikat manuell herunterladen:

Uh oh!

Uh oh!

Jason2866 Aug 5, 2025 Collaborator

macOS Certificate Issues in Python Downloads - Analysis and Solutions

Common Causes of Certificate Problems on macOS:

1. Outdated Python Certificates

2. macOS System Python (/usr/bin/python3) Issues

3. macOS Keychain Problems

4. Python.org Certificates Not Installed

5. Corporate/Proxy Environment

Standard macOS Python (/usr/bin/python3) Solutions:

Homebrew Python Solutions:

Python.org Installation Solutions:

Debugging Commands for macOS:

Additional Solution Approaches:

Set Environment Variables:

Bypass Corporate Proxy:

Manually Download Certificates:

Reset Certificate Cache:

Python Installation Type Detection:

System Python (/usr/bin/python3):

Homebrew Python (/opt/homebrew or /usr/local):

Python.org Installation (/Applications/Python):

Testing Your Solution:

Uh oh!

Jason2866 Aug 5, 2025 Collaborator

Uh oh!

geri-m Aug 5, 2025 Author

Uh oh!

Uh oh!

Jason2866 Aug 5, 2025 Collaborator

geri-m
Aug 4, 2025

Replies: 5 comments 7 replies

Jason2866
Aug 4, 2025
Collaborator

geri-m Aug 4, 2025
Author

Jason2866
Aug 4, 2025
Collaborator

geri-m Aug 4, 2025
Author

Jason2866
Aug 4, 2025
Collaborator

geri-m Aug 5, 2025
Author

Jason2866 Aug 5, 2025
Collaborator

Jason2866 Aug 5, 2025
Collaborator

Jason2866
Aug 5, 2025
Collaborator

Jason2866 Aug 5, 2025
Collaborator

geri-m Aug 5, 2025
Author

Jason2866
Aug 5, 2025
Collaborator