dev.testcontainers

Configure testcontainers for Docker and Podman integration tests in Go, Java, and Python.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/lburgazzoli/claude-plugins --skill dev-testcontainers
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dev.testcontainers
Source: https://github.com/lburgazzoli/claude-plugins/tree/main/skills/dev.testcontainers
Command: npx skills add https://github.com/lburgazzoli/claude-plugins --skill dev-testcontainers

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Running tests that rely on containerized environments can be brittle without proper testcontainers setup. This skill helps you configure and troubleshoot testcontainers for Docker and Podman, ensuring reliable test execution across engines.

Core Features & Use Cases

  • Environment detection for Docker and Podman to validate available container engines.
  • Podman compatibility guidance, including DOCKER_HOST configuration and Ryuk management.
  • Language-agnostic notes for Go, Java, and Python testcontainers usage, with CI integration tips.

Quick Start

Run tests with testcontainers by ensuring Docker or Podman is running and applying the recommended environment and host-connection configurations.

Frequently Asked Questions about dev.testcontainers

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure testcontainers to use Podman instead of Docker for integration tests?

To configure testcontainers for Podman, you need to set the DOCKER_HOST environment variable to point to the Podman socket and manage the Ryuk container for reliable test execution. This ensures compatibility across both container engines.

Does testcontainers work with Go, Java, and Python projects in CI pipelines?

Yes, testcontainers works with Go, Java, and Python projects in local environments and CI pipelines. It provides language-agnostic configuration notes and CI integration tips to ensure reliable containerized test execution across different programming languages.

Why does my testcontainers setup fail to detect the container engine?

Testcontainers fails to detect the container engine when Docker or Podman is not running or properly configured. Environment detection validates available container engines, and troubleshooting steps help ensure the host connection is correctly established for test execution.

What is the best way to troubleshoot brittle testcontainers integration tests?

The best way to troubleshoot brittle testcontainers integration tests is to apply environment detection, configure the correct host-connection settings, and manage Ryuk for Podman and Docker. This ensures reliable test execution and prevents flaky tests.

Can I run testcontainers locally without Docker using Podman?

Yes, you can run testcontainers locally using Podman instead of Docker. The setup provides Podman compatibility guidance, including DOCKER_HOST configuration and Ryuk management, to ensure reliable integration test execution in local environments.