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.
Plans
Every plan and priceFree individual developer plan
Free plan for individual developers
Free plan
Getting started
- Open the Testcontainers Desktop website
- Install the desktop app on macOS, Windows, or Linux
- Sign in with a Docker account
- Choose a local runtime such as Podman or Colima
- Connect your Testcontainers project and select local or Testcontainers Cloud execution
- 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.