# mariotoffia/FluentDocker

Use docker/podman, compose local and remote via a FluentAPI

Repository: https://github.com/mariotoffia/FluentDocker
Canonical: https://ross.abutalabs.com/products/fluentdocker
Language: C#
License: Apache-2.0
License Family: permissive
Topics: docker, net, test, fluent, compose, docker-container, builder, docker-stack, dotnetcore, docker-compose, podman, podman-compose
Last push: 2026-07-19T18:39:51+00:00

## Health v2 (maintenance only)
Score: 92/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 93, release rhythm 87, longevity 100
- inputs: {"age_days": 3815, "days_push": 45, "days_rel": 90, "gap_med": 23, "n_releases_24m": 4}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1389, forks 104 (observed 2026-08-28T04:04:35.348495+00:00)

## What it is
A .NET library providing a fluent API for managing Docker and Podman containers, images, and compose stacks locally and remotely. It includes testing packages for xUnit, MsTest, and NUnit to spin up containerized dependencies during integration tests.

## Use cases
- start nginx in a docker container from a .NET test
- run integration tests against real databases in containers
- spin up docker-compose stacks programmatically in C#
- use podman instead of docker in .NET tests
- wait for a container port to be ready before running tests
- manage docker containers from a dotnet application

## When to choose
- you are on .NET and want Testcontainers-like container lifecycle control with a fluent API
- you need to orchestrate docker-compose or docker-stack from C# code
- you want to support both Docker and Podman from the same codebase

## When to avoid
- you are not using a .NET language
- you only need to run containers via shell scripts or CI without programmatic control
- you need Kubernetes-level orchestration rather than single-host containers

## Facets
- artifact type: library
- maturity: active
- function: testing, developer-tools, container-runtime, configuration-management
- domain: developer-tools, testing
- platform: cross-platform, dotnet, windows
- tags: docker-compose, podman, fluent-api, integration-testing, testcontainers-alternative, csharp, nuget, containers, devops, docker, linux, macos

## Member repositories
- mariotoffia/FluentDocker (main) score 92

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:35.348495+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:39:42.960528+00:00, confidence not recorded.
  - readme: https://github.com/mariotoffia/FluentDocker (fetched 2026-08-28T04:04:35.348495+00:00, sha adf42d809070)
- Data as of 2026-08-30T08:39:29.467469+00:00.