Skip to content

It's not possible to use version 2026.9.0 on a Raspberry Pi 4. #5

Description

@WarC0zes

Hi,
I tried to update from version 2026.6.0 to 2026.9.0 on a Raspberry Pi 4, but it's not possible.
I've this error in the logs :

Logger: homeassistant.util.package
Source: util/package.py:222
Première occurrence: 06:42:07 (1 occurrence)
Dernier enregistrement: 06:42:07

Unable to install package pymupdf==1.28.2: × Failed to build `pymupdf==1.28.2` ├─▶ The build backend returned an error ╰─▶ Call to `setup.build_wheel` failed (exit status: 1) [stdout] [+0.0s] setup.py:184: <module>(): ### Starting. [+0.0s] setup.py:185: <module>(): os.getcwd()='/tmp/.tmplXt2rv/sdists-v9/pypi/pymupdf/1.28.2/x4g7KLeE_-UziGDq/src' [+0.0s] setup.py:185: <module>(): platform.machine()='aarch64' [+0.0s] setup.py:185: <module>(): platform.platform()='Linux-6.18.39-haos-raspi-aarch64-with-musl1' [+0.0s] setup.py:185: <module>(): platform.python_implementation()='CPython' [+0.0s] setup.py:185: <module>(): platform.python_version()='3.14.6' [+0.0s] setup.py:185: <module>(): platform.system()='Linux' [+0.1s] setup.py:185: <module>(): platform.uname()=uname_result(system='Linux', node='homeassistant', release='6.18.39-haos-raspi', version='#1 SMP PREEMPT Fri Sep 18 04:18:28 UTC 2026', machine='aarch64') [+0.1s] setup.py:185: <module>(): sys.executable='/tmp/.tmplXt2rv/builds-v0/.tmp2wzObN/bin/python' [+0.1s] setup.py:185: <module>(): sys.version='3.14.6 (main, Jun 16 2026, 10:51:59) [GCC 15.2.0]' [+0.1s] setup.py:185: <module>(): sys.version_info=sys.version_info(major=3, minor=14, micro=6, releaselevel='final', serial=0) [+0.1s] setup.py:185: <module>(): list(sys.version_info)=[3, 14, 6, 'final', 0] [+0.1s] setup.py:185: <module>(): sys.prefix='/tmp/.tmplXt2rv/builds-v0/.tmp2wzObN' [+0.1s] setup.py:185: <module>(): sys.base_prefix='/usr/local' [+0.1s] setup.py:185: <module>(): sysconfig.get_config_var("Py_GIL_DISABLED")=0 [+0.1s] setup.py:185: <module>(): sys._is_gil_enabled()=True [+0.1s] setup.py:185: <module>(): CPU bits: 64 [+0.1s] setup.py:185: <module>(): sys.argv (1): [+0.1s] setup.py:185: <module>(): 0: '-c' [+0.1s] setup.py:185: <module>(): os.environ (30): [+0.1s] setup.py:185: <module>(): HASSIO: '172.30.32.2' [+0.1s] setup.py:185: <module>(): HASSIO_TOKEN: 'd4b49aefe6a78d7038aea2eedd2560c0117578224acf0a72b733f955edxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' [+0.1s] setup.py:185: <module>(): HOME: '/root' [+0.1s] setup.py:185: <module>(): HOSTNAME: 'homeassistant' [+0.1s] setup.py:185: <module>(): HTTP_TIMEOUT: '60' [+0.2s] setup.py:185: <module>(): LANG: 'C.UTF-8' [+0.2s] setup.py:185: <module>(): OLDPWD: '/run/s6/legacy-services/home-assistant' [+0.2s] setup.py:185: <module>(): PATH: '/tmp/.tmplXt2rv/builds-v0/.tmp2wzObN/bin:/command:/usr/local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin' [+0.2s] setup.py:185: <module>(): PIP_EXTRA_INDEX_URL: 'https://wheels.home-assistant.io/musllinux-index/' [+0.2s] setup.py:185: <module>(): PWD: '/config' [+0.2s] setup.py:185: <module>(): PYTHONIOENCODING: 'utf-8:backslashreplace' [+0.2s] setup.py:185: <module>(): PYTHONMALLOC: 'mimalloc' [+0.2s] setup.py:185: <module>(): S6_BEHAVIOUR_IF_STAGE2_FAILS: '2' [+0.2s] setup.py:185: <module>(): S6_CMD_WAIT_FOR_SERVICES: '1' [+0.2s] setup.py:185: <module>(): S6_CMD_WAIT_FOR_SERVICES_MAXTIME: '0' [+0.2s] setup.py:185: <module>(): S6_SERVICES_GRACETIME: '240000' [+0.2s] setup.py:185: <module>(): S6_SERVICES_READYTIME: '50' [+0.2s] setup.py:185: <module>(): SHLVL: '2' [+0.2s] setup.py:185: <module>(): SUPERVISOR: '172.30.32.2' [+0.2s] setup.py:185: <module>(): SUPERVISOR_CORE_API_SOCKET: '/run/supervisor/core.sock' [+0.2s] setup.py:185: <module>(): SUPERVISOR_TOKEN: 'd4b49aefe6a78d7038aea2eedd2560c0117578224acf0a72b733f955ed88xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' [+0.2s] setup.py:185: <module>(): TZ: 'Europe/Paris' [+0.2s] setup.py:185: <module>(): UV: '/usr/local/bin/uv' [+0.2s] setup.py:185: <module>(): UV_INTERNAL__BUILD_DIR: '/tmp/.tmplXt2rv/sdists-v9/pypi/pymupdf/1.28.2/x4g7KLeE_-UziGDq/src' [+0.3s] setup.py:185: <module>(): UV_INTERNAL__PARENT_INTERPRETER: '/usr/local/bin/python3' [+0.3s] setup.py:185: <module>(): UV_NO_CACHE: 'true' [+0.3s] setup.py:185: <module>(): UV_SYSTEM_PYTHON: 'true' [+0.3s] setup.py:185: <module>(): VIRTUAL_ENV: '/tmp/.tmplXt2rv/builds-v0/.tmp2wzObN' [+0.3s] setup.py:185: <module>(): __BASHIO_BIN: '/usr/lib/bashio/bashio' [+0.3s] setup.py:185: <module>(): __BASHIO_LIB_DIR: '/usr/lib/bashio' [+0.3s] setup.py:195: <module>(): PYMUPDF_SETUP_URL_WHEEL=None [+0.3s] setup.py:198: <module>(): PYMUPDF_SETUP_DUMMY=None [+0.3s] ../../../../../../builds-v0/.tmp2wzObN/lib/python3.14/site-packages/pipcl/__init__.py:764: __init__(): PIPCL_CHANGE_VERSIONS=None [+0.3s] ../../../../../../builds-v0/.tmp2wzObN/lib/python3.14/site-packages/pipcl/__init__.py:833: build_wheel(): PIPCL_PREBUILT_WHEEL_pymupdf=None [+0.3s] ../../../../../../builds-v0/.tmp2wzObN/lib/python3.14/site-packages/pipcl/__init__.py:1116: tag_platform(): From self.tag_platform_: ret=None. [+0.3s] ../../../../../../builds-v0/.tmp2wzObN/lib/python3.14/site-packages/pipcl/__init__.py:1127: tag_platform(): From AUDITWHEEL_PLAT: ret=None. [+0.3s] ../../../../../../builds-v0/.tmp2wzObN/lib/python3.14/site-packages/pipcl/__init__.py:1142: tag_platform(): From sysconfig.get_platform(): ret='linux_aarch64'. [+0.3s] ../../../../../../builds-v0/.tmp2wzObN/lib/python3.14/site-packages/pipcl/__init__.py:1146: tag_platform(): tag_platform(): returning ret='linux_aarch64'. [+0.3s] setup.py:315: get_mupdf_internal(): get_mupdf_internal(): out='dir' location=None [+0.3s] setup.py:344: get_mupdf_internal(): Download location='https://mupdf.com/downloads/archive/mupdf-1.28.2-source.tar.gz' local_tgz='mupdf-1.28.2-source.tar.gz' name='mupdf-1.28.2-source' [+0.3s] setup.py:354: get_mupdf_internal(): Downloading from location='https://mupdf.com/downloads/archive/mupdf-1.28.2-source.tar.gz' to local_tgz='mupdf-1.28.2-source.tar.gz'. [+7.7s] setup.py:283: tar_extract(): Extracting mupdf-1.28.2-source.tar.gz [+15.4s] setup.py:770: build_mupdf_unix(): Setting XCFLAGS and XCXXFLAGS to predefine TOFU_CJK_EXT. [+15.4s] setup.py:802: build_mupdf_unix(): Running: cc --version [+15.4s] setup.py:802: build_mupdf_unix(): /bin/sh: cc: not found [+15.4s] setup.py:802: build_mupdf_unix(): [stderr] Traceback (most recent call last): File "<string>", line 11, in <module> wheel_filename = backend.build_wheel(__import__("os").fsdecode(b"/tmp/.tmplXt2rv/builds-v0/.tmpjfUG2F"), {}, None) File "/tmp/.tmplXt2rv/builds-v0/.tmp2wzObN/lib/python3.14/site-packages/pipcl/__init__.py", line 909, in build_wheel items = self._call_fn_build(config_settings) File "/tmp/.tmplXt2rv/builds-v0/.tmp2wzObN/lib/python3.14/site-packages/pipcl/__init__.py", line 1220, in _call_fn_build ret = self.fn_build() File "/tmp/.tmplXt2rv/sdists-v9/pypi/pymupdf/1.28.2/x4g7KLeE_-UziGDq/src/setup.py", line 476, in build mupdf_build_dir = build_mupdf_unix( mupdf_local, ...<6 lines>... PYMUPDF_SETUP_FAKE_NOGIL, ) File "/tmp/.tmplXt2rv/sdists-v9/pypi/pymupdf/1.28.2/x4g7KLeE_-UziGDq/src/setup.py", line 802, in build_mupdf_unix pipcl.run(f'{cc} --version') ~~~~~~~~~^^^^^^^^^^^^^^^^^^^ File "/tmp/.tmplXt2rv/builds-v0/.tmp2wzObN/lib/python3.14/site-packages/pipcl/__init__.py", line 3359, in run raise subprocess.CalledProcessError(e, command2, capture_text if capture else None) subprocess.CalledProcessError: Command 'cc --version' returned non-zero exit status 127. hint: Build failures usually indicate a problem with the package or the build environment

Can you correct this?

Core: 2026.9.3
Supervisor: 2026.09.2
HAOS: 18.3

edit:
Claude response:
This error stems from an attempt by Home Assistant to install the Python package pymupdf (version 1.28.2), which fails during compilation. Here is the chain of events:

  1. No precompiled wheel available
    For the aarch64 architecture (your HAOS is running on a 64-bit Raspberry Pi) with Python 3.14, there is no ready-to-use binary wheel for pymupdf 1.28.2 on the index being used (wheels.home-assistant.io). Consequently, pip/uv is forced to compile the package from source.

  2. Compilation fails: no C compiler
    The log clearly shows this at the end:

setup.py:802: build_mupdf_unix(): Running: cc --version
setup.py:802: build_mupdf_unix(): /bin/sh: cc: not found

The Home Assistant OS container does not include a C compiler (cc, gcc, etc.), which is normal—it is a minimalist environment not designed for compiling native packages. Furthermore, pymupdf bundles the entire MuPDF source code (downloaded separately, as indicated by the .tar.gz file), making it a heavy C/C++ compilation task that is impossible without a toolchain.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions