2026.6 stable Docker image: 'No module named homeassistant' — broken package metadata (amd64)

[sasharif87]

The problem

The stable and 2026.6 Docker images for amd64 (ghcr.io/home-assistant/home-assistant:stable) crash immediately on startup with:

/usr/local/bin/python3: No module named homeassistant
Home Assistant Core finish process exit code 1
Home Assistant Core service shutdown

The container enters a restart loop. This affects fresh pulls — not a caching issue.

Root cause

The homeassistant package has broken metadata inside the image. pip list shows:

homeassistant                      None

And pip reports:

WARNING: Error parsing direct_url.json for homeassistant: Expecting value: line 1 column 1 (char 0)

The package is technically installed (shows in pip list) but Python cannot import it because the metadata is corrupt — direct_url.json is empty/malformed.

Reproduction

# Fails — stable / 2026.6
docker run --rm ghcr.io/home-assistant/home-assistant:stable \
  python3 -c 'import homeassistant'
# ModuleNotFoundError: No module named 'homeassistant'

# Works — 2026.5
docker run --rm ghcr.io/home-assistant/home-assistant:2026.5 \
  python3 -c 'import homeassistant.const; print(homeassistant.const.__version__)'
# 2026.5.4

Both tags resolve to different digests:

• stable / 2026.6: sha256:adb3341e31e03e0048e60d8c1cf952e118a381ae258bb921d3da12a3b27bf0c2
• 2026.5: sha256:ceb1202133a5a036e8b03e20a10eb113186cc2f871968323c6fc6c3fc4205716

Environment

• Platform: amd64 (Ubuntu 24.04 VM, Docker 27.x)
• Installation: Docker Compose (not HAOS/Supervised)
• Image: ghcr.io/home-assistant/home-assistant:stable
• Working version: 2026.5.4

Workaround

Pin to 2026.5 until a fixed 2026.6.x image is published:

image: ghcr.io/home-assistant/home-assistant:2026.5