eShopOnContainers: .NET Microservices Reference
eShopOnContainers is worth studying only as a historical snapshot: Microsoft archived it in November 2023 and moved active development to dotnet/eShop, freezing this repo's patterns at .NET 7. If you want DDD and container-based microservices laid out end-to-end in one .NET codebase, it still does that job — just don't treat its 'dev' branch as current guidance for a live project.
What eShopOnContainers demonstrates
eShopOnContainers is a Microsoft reference sample for building a .NET e-commerce backend as independently deployable microservices using Domain-Driven Design, each in its own Docker container. It pairs a SPA web client with a Xamarin mobile client against that backend, and documents deployment to Azure Kubernetes Service on Linux, Windows, and macOS. The project moved to dotnet/eShop in November 2023. This repo is now archived.
Architecture patterns and technologies covered
- ✓Domain-Driven Design applied across separate microservices rather than one monolithic bounded context.
- ✓Each service packaged as its own Docker container, matching the repo's docker and windowscontainers topics.
- ✓.NET 7 backend code that runs on Linux, Windows, and macOS from the same codebase.
- ✓A SPA web client and a Xamarin mobile client both calling the same backend services.
- ✓Documented deployment path to Azure Kubernetes Service for container orchestration.
- ✓Support for Visual Studio, VS for Mac, VS Code, and CLI workflows via the docker CLI and dotnet CLI.
Strengths
- ✓Ties DDD, containerization, multi-platform targeting, and multi-client (web plus mobile) integration together in one codebase instead of separate toy demos.
- ✓Backed by Microsoft, so the architecture follows documented .NET guidance rather than one developer's personal opinion.
- ✓The 'dev' branch keeps the pre-migration code browsable even though the main branch is now a read-only archive.
Known limitations of this reference architecture
- △Read-only archive since November 2023 — nothing here reflects .NET tooling or package versions released after that date.
- △Frozen at .NET 7, which is already older than whatever ships in dotnet/eShop today.
- △The 'dev' branch holds the old code but comes with no migration guide or changelog explaining what changed.
Where to find the active eShop project
Frequently asked questions
eShopOnContainers moved to the dotnet/eShop repository on GitHub as of November 2023, and Microsoft continues active development of the sample there.
eShopOnContainers was built and documented as a learning sample, not a production template, and the repository is now a read-only archive — for current production-style guidance, dotnet/eShop is the maintained version to reference instead.
eShopOnContainers is powered by .NET 7 according to the repository description, and that version is frozen since the repo no longer receives updates.
eShopOnContainers documents deployment to Azure Kubernetes Service as part of its container-based architecture, alongside plain Docker container support.
eShopOnContainers is written primarily in C#, which is GitHub's listed language for the repository, matching its .NET and ASP.NET Core based services.
The old eShopOnContainers code that predates the November 2023 migration is still available — it lives in this repository's 'dev' branch, separate from the now-archived main branch.
Best use cases
- •Learning how to split an e-commerce domain into DDD-bounded microservices instead of one monolith.
- •Studying a worked example that pairs a containerized .NET backend with both a web SPA and a Xamarin mobile client.
- •Comparing this .NET 7 architecture against the actively maintained dotnet/eShop before starting a new project.
Who should try it — and who should skip
Try eShopOnContainers if you're learning DDD-based microservices in .NET and want one worked example that ties together containerization, a SPA front end, and a Xamarin mobile client instead of reading about each piece separately. Skip it if you need current guidance for a real project — go straight to dotnet/eShop instead, since this repo stopped receiving updates in November 2023 and its .NET 7 baseline is already dated.
Related repositories
Is eShopOnContainers worth your time?
ChatGPT, Claude and Perplexity can all read this page. Ask one of them what it makes of eShopOnContainers.
