Skip to content
SPECIFICTION
Get listed

Testcontainers Desktop

testcontainers.com

Free plan WebWindowsmacOSLinuxAPISelf-hosted

What it is

Testcontainers Desktop is a companion app for the open source Testcontainers libraries, for local development and testing with real dependencies. The closed-source app runs in the system tray and lets users switch between local container runtimes, including Podman and Colima. It can also run containers through Testcontainers Cloud on demand without local resources or a local Docker daemon. Users can expose services on fixed ports for debugging tools, inspect container logs, and open a shell for a configured service. A beta freeze option can stop containers from shutting down after tests, while session tracking feeds collaborative dashboards with desktop and CI data from an organization. More than 15 example service configurations include PostgreSQL and Kafka. The embedded runtime is beta and requires macOS 11 or later. A Docker account is required to sign in. The free plan includes 300 minutes of cloud runtime per month; Turbo mode requires a paid account.

Spec sheet

What it does
Testcontainers Desktop is a system-tray companion for running and debugging Testcontainers-based development and tests.Read 15 Oct 2026 · testcontainers.com
Purpose
Testcontainers Desktop is a companion app for the open source Testcontainers libraries, intended to improve local development and testing with real dependencies.Read 7 Oct 2026 · testcontainers.com
Support
The docs direct users experiencing embedded-runtime issues to the public Testcontainers Slack channel.Read 7 Oct 2026 · testcontainers.com
App type
The app is closed-source, lightweight, and runs in the system tray.Read 7 Oct 2026 · testcontainers.com
Application licence
The desktop application is closed source, while the Testcontainers libraries are open source.Read 15 Oct 2026 · testcontainers.com
Authentication requirement
Unauthenticated use is not supported; first launch requires a Docker account sign-in.Read 15 Oct 2026 · testcontainers.com
Cloud architecture
The Cloud agent opens an SSH tunnel to a remote Docker daemon and deletes allocated resources after tests finish.Read 15 Oct 2026 · testcontainers.com
Cloud execution
Testcontainers Cloud runs containers remotely, avoiding a local Docker daemon and providing Linux x86 workers.Read 15 Oct 2026 · testcontainers.com
Cloud filesystem limitation
Mounting the local filesystem into cloud containers is not implemented; file-copy methods are the documented workaround.Read 15 Oct 2026 · testcontainers.com
Cloud memory limit
Each Testcontainers Cloud session receives 8 GB of RAM and the session limit cannot currently be changed.Read 15 Oct 2026 · testcontainers.com
Cloud pricing model
Docker Pro, Team and Business include 100, 500 and 1,500 Testcontainers Cloud runtime minutes per month respectively.Read 15 Oct 2026 · testcontainers.com
Cloud registry security
Private-registry credentials are visible to the Testcontainers library and Cloud during proxying but are not stored.Read 15 Oct 2026 · testcontainers.com
Cloud runtime
Testcontainers Desktop can run containers through Testcontainers Cloud on demand without using local resources or requiring a local Docker daemon.Read 7 Oct 2026 · testcontainers.com
Company acquisition
Docker announced on December 11, 2023 that it acquired New York-based AtomicJar, the company behind Testcontainers.Read 15 Oct 2026 · docker.com
Company founding
LinkedIn lists Testcontainers as founded in 2015 and describes the organization as a 2–10 employee nonprofit.Read 15 Oct 2026 · linkedin.com
Container inspection
The app provides menu actions to review container logs and open a shell for a configured service.Read 7 Oct 2026 · testcontainers.com
Container lifecycle
The beta freeze feature can halt container shutdown so users can inspect containers after tests finish.Read 7 Oct 2026 · testcontainers.com
Container logs and shell
Configured services expose one-click actions for viewing logs and opening a shell.Read 15 Oct 2026 · testcontainers.com
Container termination
A terminate command removes running Testcontainers-managed containers while leaving ordinary containers alone.Read 15 Oct 2026 · testcontainers.com
Developer support
Support routes include a knowledge base, issue reporting and a public Slack channel for Testcontainers Desktop.Read 15 Oct 2026 · testcontainers.com
Docker context
The app creates a dynamic tcc or tcd Docker context, but does not automatically change the user's active Docker context.Read 15 Oct 2026 · testcontainers.com
Documentation depth
Documentation includes installation, runtime selection, debugging, lifecycle management, dashboards, account administration and troubleshooting.Read 15 Oct 2026 · testcontainers.com
Embedded runtime
The embedded runtime is beta and requires macOS 11 or later.Read 15 Oct 2026 · testcontainers.com
Fixed-port debugging
Users can map container ports to fixed host ports for database IDE plugins, k9s and other debugging tools.Read 15 Oct 2026 · testcontainers.com
Freeze feature
Freeze mode pauses managed container shutdown so developers can inspect test state before cleanup.Read 15 Oct 2026 · testcontainers.com
Freeze limitation
Freeze mode does not currently support long-lived unmanaged containers such as singleton or reusable containers.Read 15 Oct 2026 · testcontainers.com
Funding
Crunchbase lists AtomicJar's January 2023 Series A as its latest funding round and says the company was funded by 13 investors.Read 15 Oct 2026 · crunchbase.com
Independent integration detail
Docker's integration article explains that Desktop port forwarding exposes Testcontainers services such as databases and message brokers on stable local ports.Read 15 Oct 2026 · docker.com
Integration coverage
Testcontainers libraries are available for Java, Go, .NET, Node.js, Python, Rust, Ruby, PHP, Haskell, Clojure, Elixir, Scala, and Native.Read 7 Oct 2026 · testcontainers.com
Limit: runtime dependency
QAble notes that using the libraries still requires a container runtime on developer machines and in CI, with associated compute and image-storage costs.Read 15 Oct 2026 · qable.io
Limitations
The beta reusable-container feature has language-specific limitations, including unsupported reuse in some Testcontainers languages.Read 7 Oct 2026 · testcontainers.com
Notable debugging release
An August 4, 2023 announcement added service verification and TOML configuration reloads for fixed-port services.Read 15 Oct 2026 · newsletter.testcontainers.com
Notable feature release
The October 2023 product roundup announced the embedded runtime beta in version 1.4.18, limited to macOS 11 or later.Read 15 Oct 2026 · newsletter.testcontainers.com
Notable news
AtomicJar announced its macOS Homebrew installation command on February 24, 2023.Read 15 Oct 2026 · newsletter.testcontainers.com
Praise: open-source value
QAble says the libraries are free and open source with no paid edition or withheld library features.Read 15 Oct 2026 · qable.io
Praise: usability
Baeldung describes the interface as minimal and highlights freezing containers, fixed ports, configuration and direct container interaction.Read 15 Oct 2026 · baeldung.com
Praise: workflow visibility
Baeldung highlights the dashboard's summaries of containers, images, recent activity and execution environments.Read 15 Oct 2026 · baeldung.com
Public language APIs
The Testcontainers ecosystem publishes libraries for Java, Go, .NET, Node.js, Python, Rust, Ruby, PHP, Haskell, Clojure, Elixir, Scala and native languages.Read 15 Oct 2026 · github.com
Reusable containers
Reusable containers can reduce startup time but are experimental, unsuitable for CI and unsupported by some language implementations.Read 15 Oct 2026 · testcontainers.com
Runtime integrations
The product page specifically mentions Podman and Rancher as runtimes users can switch to.Read 15 Oct 2026 · testcontainers.com
Runtime selection
It can switch Testcontainers between Docker Desktop, Docker Engine on Linux, Testcontainers Cloud and its embedded macOS runtime.Read 15 Oct 2026 · testcontainers.com
Security detail
The browser terminal is limited to localhost and secured by a unique hash.Read 7 Oct 2026 · testcontainers.com
Service configuration
The app ships with more than 15 example TOML service configurations, including PostgreSQL and Kafka.Read 15 Oct 2026 · testcontainers.com
Service debugging
Users can expose container services on fixed ports to connect debugging tools, such as IDE plugins or k9s.Read 7 Oct 2026 · testcontainers.com
Session analytics
The app tracks test sessions and provides collaborative dashboards with test data from desktop and CI users in an organization.Read 7 Oct 2026 · testcontainers.com
Session dashboards
Dashboards aggregate desktop and CI test data and show timelines, image usage, dependency age and parallelization information.Read 15 Oct 2026 · testcontainers.com
Sign-in requirement
Users must sign in with a Docker account; unauthenticated use is not supported.Read 7 Oct 2026 · testcontainers.com
Supported operating systems
The desktop app is available for macOS, Windows and Linux.Read 15 Oct 2026 · testcontainers.com
Technology configurations
The app includes more than 15 example service configuration files for popular technologies, including PostgreSQL and Kafka.Read 7 Oct 2026 · testcontainers.com
Terminal access
Its browser terminal is restricted to localhost and protected by a unique hash.Read 15 Oct 2026 · testcontainers.com
Turbo mode
Turbo mode assigns separate cloud environments to parallel test processes, but free accounts cannot use it.Read 15 Oct 2026 · testcontainers.com

Plans and prices

Free individual developer plan Free 300 cloud-runtime minutes per month · local runtimes unrestricted Read 15 Oct 2026 · testcontainers.com
Free plan for individual developers Free 300 minutes of cloud runtime per month · Turbo mode requires a paid account Read 7 Oct 2026 · testcontainers.com

Every Testcontainers Desktop plan and price →

Strong points and limits

Strong points

  • Switches between local runtimes, including Podman and Colima.
  • Cloud runs do not require local resources or Docker daemon.
  • Fixed ports support connections from debugging tools.
  • Includes more than 15 service configuration examples.
  • Free plan includes 300 monthly cloud-runtime minutes.

Limits

  • Docker account sign-in is required.
  • Embedded runtime is beta and limited to macOS 11 or later.
  • Turbo mode requires a paid account.
  • Reusable-container beta has language-specific limitations.

Who it suits

It suits developers using Testcontainers libraries who want to manage local or cloud container runs and inspect services during testing. Its runtime options and integrations cover a range of Testcontainers language libraries.

Verdict

Testcontainers Desktop brings runtime selection, service inspection, and session dashboards into a system-tray companion for Testcontainers libraries. The free plan has a stated cloud-runtime allowance, but sign-in is mandatory and some features remain in beta.

Where Specifiction places it

Alternatives to Testcontainers DesktopAll alternatives →