Skip to content

docs: add kosa8 to supported Docker environments - #1134

Open
drvt69talati wants to merge 2 commits into
testcontainers:mainfrom
drvt69talati:docs/kosa8-runtime
Open

drvt69talati wants to merge 2 commits into
testcontainers:mainfrom
drvt69talati:docs/kosa8-runtime

Conversation

@drvt69talati

@drvt69talati drvt69talati commented Oct 15, 2026 •

Copy link
Copy Markdown

Adds a short kosa8 section to "Supported Docker environments", next to Podman.

kosa8 serves a Docker-compatible API on a Unix socket. The section gives the two environment variables needed (DOCKER_HOST and TESTCONTAINERS_RYUK_DISABLED=true) and lists the known limitations.

Tested on macOS (arm64) with testcontainers 4.15.0, docker (Python SDK) 7.2.0, Python 3.12.13 and kosa8 v0.9.10, using only the settings in the new section:

  • Passed: RedisContainer, PostgresContainer (SQLAlchemy + psycopg2), KafkaContainer (confluentinc/cp-kafka:7.6.0, produce/consume with kafka-python), and DockerContainer with a log wait and exec
  • Fails by design: Ryuk with default settings (kosa8 refuses to share its API socket with a container, hence TESTCONTAINERS_RYUK_DISABLED)

Docs-only change.

🤖 Generated with Claude Code

drvt69talati and others added 2 commits October 15, 2026 17:38
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
KafkaContainer now passes (files can be copied into containers) and bind
mounts work for allowed directories. Ryuk stays disabled.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@drvt69talati

Copy link
Copy Markdown
Author

Updated for kosa8 v0.9.10, retested today on macOS (arm64) with testcontainers 4.15.0: RedisContainer, PostgresContainer and now KafkaContainer pass (kosa8 now supports copying files into containers). Bind mounts work for directories allowed with kosa8 daemon start --allow-mount. Ryuk still has to be disabled (TESTCONTAINERS_RYUK_DISABLED=true), since kosa8 never shares its API socket with a container; the limitations list says so.

This branch has not been deployed

No deployments
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