Skip to content

Fix Claude CLI installation by switching to Debian base images#58

Open
hack2spider wants to merge 3 commits intoheytcass:mainfrom
hack2spider:main
Open

Fix Claude CLI installation by switching to Debian base images#58
hack2spider wants to merge 3 commits intoheytcass:mainfrom
hack2spider:main

Conversation

@hack2spider
Copy link

Summary

  • Fixed Claude CLI installation failure caused by musl libc incompatibility
  • Switched from Alpine-based to Debian-based Home Assistant images
  • Updated package management from apk to apt-get
  • Added ttyd installation from GitHub releases (not available in Debian repos)

Problem

The Claude CLI binary requires glibc symbols (posix_getdents) that are not available in Alpine's musl libc, causing the installation to fail with:

Error relocating /root/.claude/downloads/claude-2.1.63-linux-x64-musl: posix_getdents: symbol not found

Changes

build.yaml:

  • Changed base images from ghcr.io/home-assistant/*-base:3.19 to ghcr.io/home-assistant/*-base-debian:bookworm

Dockerfile:

  • Replaced apk add with apt-get install
  • Updated package names for Debian compatibility
  • Added yq installation via pip (not in Debian repos)

run.sh:

  • Replaced apk commands with apt-get
  • Added ttyd binary download from GitHub releases (not in Debian repos)

Testing

Tested on Home Assistant OS with amd64 architecture. Add-on builds and runs successfully.

🤖 Generated with Claude Code

hack2spider and others added 3 commits March 1, 2026 00:21
The Claude CLI binary requires glibc symbols (posix_getdents) not
available in Alpine's musl libc. This switches the base images from
Alpine to Debian bookworm to resolve the installation error.

Changes:
- build.yaml: Use Debian-based Home Assistant images
- Dockerfile: Replace apk with apt-get, update package names

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
The run.sh script was still using Alpine's apk package manager
which doesn't exist on Debian. Changed to apt-get.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
ttyd is not available in Debian repos, so download the binary
directly from GitHub releases instead.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant