Skip to content


Container Runtime Client

Testcontainers configures an underlying container runtime to perform its tasks. This runtime works automatically with several providers like Docker, Podman, Colima, Rancher Desktop and Testcontainers Desktop. There are too many usage examples to list here, but here are some common examples:

Fetch container runtime information

import { getContainerRuntimeClient } from "testcontainers";

const containerRuntimeClient = await getContainerRuntimeClient();


Pulling an image

import { ImageName } from "testcontainers";

await containerRuntimeClient.image.pull(ImageName.fromString("alpine:3.12"))

Starting a container

const container = await containerRuntimeClient.container.create({ ... });
await containerRuntimeClient.container.start(container);

Starting a Docker Compose environment

const environment = await containerRuntimeClient.compose.up({ ... })

Starting a network

const network = await{ ... })