Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

Testcontainers Desktop

testcontainers.com

  • Free plan
  • Windows
  • macOS
  • Linux
  • Web
  • API
  • Self-hosted

What Testcontainers Desktop is

Testcontainers Desktop is a companion app for the open-source Testcontainers libraries, designed to support local development and testing with real dependencies. The closed-source app runs in the system tray and lets users switch between local container runtimes such as Podman and Colima. It can also run containers through Testcontainers Cloud on demand without local resource use or a local Docker daemon. For debugging, users can expose services on fixed ports, review container logs, and open a shell for a configured service. A beta freeze feature can halt container shutdown after tests finish, and session analytics feeds collaborative dashboards with desktop and CI test data from an organization. The app includes more than 15 example service configurations, including PostgreSQL and Kafka. Its free plan offers 300 minutes of cloud runtime per month, but Turbo mode requires a paid account. Users must sign in with a Docker account. The embedded runtime is beta and available on macOS 11 or later; desktop support covers macOS, Windows, and Linux.

Who it suits

It suits developers using Testcontainers libraries who want runtime switching, service debugging, or shared test-session dashboards. Teams may also use its cloud runtime without requiring a local Docker daemon.

Good to know, and what to watch

  • Switches between local runtimes such as Podman and Colima.
  • Cloud runs do not require a local Docker daemon.
  • Container logs and shells aid service inspection.
  • Free plan includes 300 cloud-runtime minutes monthly.
  • Docker account sign-in is required.
  • Embedded runtime is beta and limited to macOS 11 or later.
  • Turbo mode requires a paid account.

Free individual developer plan

Free

Free plan for individual developers

Free

Free plan

Getting started

  1. Open the Testcontainers Desktop website
  2. Install the desktop app on macOS, Windows, or Linux
  3. Sign in with a Docker account
  4. Choose a local runtime such as Podman or Colima
  5. Connect your Testcontainers project and select local or Testcontainers Cloud execution
  6. Use the provided service configurations, Compose workflows, or IDE integration

Limits to check

The individual Free plan includes 300 minutes of cloud runtime per month, and Turbo mode requires a paid account. The embedded runtime is beta and available on macOS 11 or later; the beta reusable-container feature has language-specific limitations.

The verdict

Testcontainers Desktop adds runtime controls, debugging actions, and session dashboards around the Testcontainers libraries. Note the required Docker sign-in and beta status of the embedded runtime when assessing fit.

Questions people ask

Is Testcontainers Desktop free?

Yes. The individual developer Free plan costs nothing and includes 300 minutes of cloud runtime per month.

Does it require a Docker account?

Yes. Users must sign in with a Docker account, and unauthenticated use is not supported.

Which desktop platforms are supported?

The app supports macOS, Windows, and Linux. Its embedded runtime is available in beta on macOS 11 or later.

Can it run containers without a local Docker daemon?

Yes. Testcontainers Desktop can use Testcontainers Cloud on demand without local resources or a local Docker daemon.

Which programming languages work with Testcontainers libraries?

Libraries are available for Java, Go, .NET, Node.js, Python, Rust, Ruby, PHP, Haskell, Clojure, Elixir, Scala, and Native.

What can the app inspect or debug?

Users can expose services on fixed ports, review container logs, open a shell for a configured service, and freeze container shutdown in beta after tests finish.

What the maker publishes

Application licence
The desktop application is closed source, while the Testcontainers libraries are open source. source
App type
The app is closed-source, lightweight, and runs in the system tray. source
Authentication requirement
Unauthenticated use is not supported; first launch requires a Docker account sign-in. source
Cloud architecture
The Cloud agent opens an SSH tunnel to a remote Docker daemon and deletes allocated resources after tests finish. source
Cloud execution
Testcontainers Cloud runs containers remotely, avoiding a local Docker daemon and providing Linux x86 workers. source
Cloud filesystem limitation
Mounting the local filesystem into cloud containers is not implemented; file-copy methods are the documented workaround. source
Cloud memory limit
Each Testcontainers Cloud session receives 8 GB of RAM and the session limit cannot currently be changed. source
Cloud pricing model
Docker Pro, Team and Business include 100, 500 and 1,500 Testcontainers Cloud runtime minutes per month respectively. source
Cloud registry security
Private-registry credentials are visible to the Testcontainers library and Cloud during proxying but are not stored. source
Cloud runtime
Testcontainers Desktop can run containers through Testcontainers Cloud on demand without using local resources or requiring a local Docker daemon. source
Company acquisition
Docker announced on December 11, 2023 that it acquired New York-based AtomicJar, the company behind Testcontainers. source
Company founding
LinkedIn lists Testcontainers as founded in 2015 and describes the organization as a 2–10 employee nonprofit. source
Container inspection
The app provides menu actions to review container logs and open a shell for a configured service. source
Container lifecycle
The beta freeze feature can halt container shutdown so users can inspect containers after tests finish. source
Container logs and shell
Configured services expose one-click actions for viewing logs and opening a shell. source
Container termination
A terminate command removes running Testcontainers-managed containers while leaving ordinary containers alone. source
Developer support
Support routes include a knowledge base, issue reporting and a public Slack channel for Testcontainers Desktop. source
Docker context
The app creates a dynamic tcc or tcd Docker context, but does not automatically change the user's active Docker context. source
Documentation depth
Documentation includes installation, runtime selection, debugging, lifecycle management, dashboards, account administration and troubleshooting. source
Embedded runtime
The embedded runtime is in beta and is available on macOS 11 or later. source
Embedded runtime
The embedded runtime is beta and requires macOS 11 or later. source
Fixed-port debugging
Users can map container ports to fixed host ports for database IDE plugins, k9s and other debugging tools. source
Freeze feature
Freeze mode pauses managed container shutdown so developers can inspect test state before cleanup. source
Freeze limitation
Freeze mode does not currently support long-lived unmanaged containers such as singleton or reusable containers. source

Checked against the maker's pages on 15 Oct 2026.