Skip to content

fix: replace localhost with 127.0.0.1 in all healthcheck definitions#736

Open
yasinBursali wants to merge 2 commits intoLight-Heart-Labs:mainfrom
yasinBursali:fix/healthcheck-localhost-to-ipv4
Open

fix: replace localhost with 127.0.0.1 in all healthcheck definitions#736
yasinBursali wants to merge 2 commits intoLight-Heart-Labs:mainfrom
yasinBursali:fix/healthcheck-localhost-to-ipv4

Conversation

@yasinBursali
Copy link
Copy Markdown
Contributor

What

Replace all localhost references in Docker healthcheck test: lines with 127.0.0.1 to prevent IPv6 resolution failures.

Why

On dual-stack hosts, localhost may resolve to ::1 (IPv6). Services listening only on IPv4 become unreachable, causing healthcheck failures that cascade through depends_on: condition: service_healthy — potentially bringing down the entire stack.

How

19 replacements across 17 files: docker-compose.base.yml, docker-compose.amd.yml, 12 extension compose files, and 2 extension templates. Only healthcheck test: lines changed — environment variables left untouched.

Testing

  • Grep confirms zero remaining localhost in active healthcheck lines ✅
  • YAML syntax validated ✅

Platform Impact

All platforms (especially dual-stack Linux hosts with IPv6 enabled)

🤖 Generated with Claude Code

yasinBursali and others added 2 commits April 3, 2026 02:42
…ibility

Use explicit IPv4 address in llama-server healthcheck and extension
compose template to prevent failures on dual-stack hosts where localhost
resolves to ::1.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…tions

Extend IPv4-explicit healthchecks to all compose files including core
services, extensions, GPU overlays, and templates.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Copy link
Copy Markdown
Collaborator

@Lightheartdevs Lightheartdevs left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Audit Review

The change itself is correct and follows Docker best practices — 127.0.0.1 is more reliable than localhost in containers that may lack /etc/hosts or resolve localhost to IPv6.

Blocking: Docker Compose validation CI failure

"Validate Docker Compose files" is failing. Investigate whether the changes introduced a syntax issue, or if this is the pre-existing llama-server image failure. If it's the pre-existing one (llama-server has no image in base.yml), then this is not blocking.

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.

2 participants