docs: document DinD + airlock known limitation (#20)#102
Merged
GordonBeeming merged 2 commits intomainfrom Apr 9, 2026
Merged
Conversation
The airlock's internal: true network prevents the workload from reaching host port mappings via raw TCP, causing Testcontainers to time out on sibling container connections. Filed #101 with analysis and potential solutions. Workaround: use --dind without --airlock. Also adds gitignore entries for .playwright-mcp/ snapshots and .claude/scheduled_tasks.lock. Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com> Co-authored-by: GitButler <gitbutler@gitbutler.com>
GordonBeeming
force-pushed
the
gb/dind-airlock-known-issue
branch
from
0e770d1 to
c30d470
Compare
Contributor
There was a problem hiding this comment.
Pull request overview
Documents a known limitation when combining --dind with airlock mode on macOS/Windows, and records the recommended workaround.
Changes:
- Add a known-issues entry describing Testcontainers connectivity failures for DinD + airlock on macOS/Windows, linking to the deeper investigation in #101.
- Update
.gitignoreto exclude Playwright MCP snapshot output and a Claude scheduled-tasks lock file.
Reviewed changes
Copilot reviewed 1 out of 2 changed files in this pull request and generated 1 comment.
| File | Description |
|---|---|
| docs/known-issues.md | Adds the DinD + airlock/Testcontainers limitation and points users to #101 + workaround guidance. |
| .gitignore | Ignores additional generated tool artifacts to avoid accidental commits. |
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com> Co-authored-by: GitButler <gitbutler@gitbutler.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
--dind+ airlock mode has Testcontainers connectivity issues on macOS/Windowsinternal: trueairlock network blocks raw TCP tohost.docker.internal, so Testcontainers times out on sibling container port mappings--dindwithout--airlockTest plan
Closes #20 (partially -- DinD works without airlock; airlock+DinD tracked in #101)