{"id":15070,"date":"2026-01-14T13:45:34","date_gmt":"2026-01-14T05:45:34","guid":{"rendered":"https:\/\/www.cybermedian.com\/in\/docs\/my-document\/module-3-level-2-diving-into-container-diagrams\/what-is-a-container\/"},"modified":"2026-01-15T11:11:01","modified_gmt":"2026-01-15T03:11:01","slug":"what-is-a-container","status":"publish","type":"docs","link":"https:\/\/www.cybermedian.com\/in\/docs\/mastering-c4-model\/module-3-level-2-diving-into-container-diagrams\/what-is-a-container\/","title":{"rendered":"What is a “Container”?"},"content":{"rendered":"

Distinguishing C4 containers from Docker containers<\/strong><\/p>\n

One of the most frequent points of confusion when people first encounter the C4 Model is the term \u201cContainer\u201d<\/strong> \u2014 especially in 2025\u20132026, when nearly everyone associates \u201ccontainer\u201d with Docker, Kubernetes, container images, and OCI runtimes.<\/p>\n

The C4 Model uses the word Container<\/strong> in a completely different, higher-level, architectural<\/strong> sense \u2014 and it\u2019s important to clearly separate the two concepts right from the start.<\/p>\n

C4 Container: The Architectural \/ Logical Definition<\/h3>\n

In the C4 Model, a Container<\/strong> is:<\/p>\n

\n

A separately runnable or deployable unit of software that executes code or hosts data.<\/p>\n<\/blockquote>\n

It represents a cohesive, bounded piece of the system<\/strong> that:<\/p>\n

    \n
  • Has its own distinct runtime\/process boundary<\/li>\n
  • Can be developed, built, tested, deployed, scaled, monitored, and (in many cases) replaced somewhat independently<\/li>\n
  • Delivers a significant portion of the overall system\u2019s responsibility<\/li>\n<\/ul>\n

    This is a logical \/ architectural abstraction<\/strong>, not tied to any specific deployment technology.<\/p>\n

    Examples of C4 Containers (regardless of how they are actually deployed):<\/p>\n

      \n
    • A Spring Boot REST API service<\/li>\n
    • A React single-page application (SPA) served from its own domain<\/li>\n
    • A native iOS or Android mobile app<\/li>\n
    • A PostgreSQL database instance (or schema logically separated for this system)<\/li>\n
    • A Kafka topic cluster used for event streaming<\/li>\n
    • An AWS Lambda function or group of related functions<\/li>\n
    • A background worker \/ scheduled batch job<\/li>\n
    • A third-party SaaS service treated as a black box (e.g., Stripe, Auth0)<\/li>\n<\/ul>\n

      Key characteristics at Level 2:<\/p>\n

        \n
      • Focus on responsibility<\/strong>, technology choice<\/strong>, and interaction style<\/strong> (HTTP, gRPC, JDBC, AMQP, etc.)<\/li>\n
      • No concern for pods, nodes, replicas, Helm charts, or container orchestration details yet<\/li>\n<\/ul>\n

        Docker \/ OCI Container: The Deployment \/ Runtime Definition<\/h3>\n

        In the DevOps and cloud-native world, a container<\/strong> (lowercase, usually referring to Docker\/OCI containers) is:<\/p>\n

        \n

        A standardized, lightweight, portable unit of software packaging and execution that includes code + dependencies + runtime environment, isolated via OS-level virtualization (namespaces, cgroups, etc.).<\/p>\n<\/blockquote>\n

        It is a deployment and runtime artifact<\/strong>:<\/p>\n

          \n
        • Built from a Dockerfile or similar<\/li>\n
        • Runs via Docker, containerd, Podman, CRI-O, etc.<\/li>\n
        • Orchestrated by Kubernetes, Docker Compose, ECS, Nomad, etc.<\/li>\n
        • Typically one process per container (following the \u201cone process per container\u201d best practice)<\/li>\n<\/ul>\n

          Examples:<\/p>\n

            \n
          • A Docker image running your Spring Boot JAR<\/li>\n
          • A containerized NGINX reverse proxy<\/li>\n
          • A PostgreSQL Docker container running the database server<\/li>\n<\/ul>\n

            Side-by-Side Comparison<\/h3>\n
            \n
            \n
            <\/div>\n<\/div>\n
            \n
            <\/div>\n\n\n\n\n\n\n\n\n\n\n\n
            Aspect<\/th>\nC4 Container (Level 2)<\/th>\nDocker\/OCI Container<\/th>\n<\/tr>\n<\/thead>\n
            Level of abstraction<\/strong><\/td>\nArchitectural \/ logical<\/td>\nDeployment \/ runtime<\/td>\n<\/tr>\n
            Purpose<\/strong><\/td>\nCommunicate high-level structure & technology choices<\/td>\nPackage, distribute, and run software in isolation<\/td>\n<\/tr>\n
            Scope<\/strong><\/td>\nCan span multiple physical containers \/ pods<\/td>\nOne process \/ image instance<\/td>\n<\/tr>\n
            Technology-specific?<\/strong><\/td>\nNo \u2014 can be monolith, microservice, serverless, etc.<\/td>\nYes \u2014 tied to container runtime standards<\/td>\n<\/tr>\n
            Examples<\/strong><\/td>\n\u201cOrder Service (Java)\u201d, \u201cMobile App (iOS)\u201d, \u201cKafka Event Bus\u201d<\/td>\norder-service:1.2.3, postgres:16, kafka-broker<\/td>\n<\/tr>\n
            Deployment detail<\/strong><\/td>\nNot shown (deferred to Deployment Diagram)<\/td>\nVery specific (image tags, ports, volumes, etc.)<\/td>\n<\/tr>\n
            When you see it<\/strong><\/td>\nIn C4 Container Diagrams<\/td>\nIn Dockerfile, Kubernetes manifests, CI pipelines<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
            <\/div>\n<\/div>\n<\/div>\n

            Practical Rule of Thumb<\/h3>\n
              \n
            • If you\u2019re talking about architecture<\/strong>, responsibilities<\/strong>, communication protocols<\/strong>, and technology choices<\/strong> \u2192 you\u2019re talking about C4 Containers<\/strong>.<\/li>\n
            • If you\u2019re talking about images<\/strong>, Dockerfiles<\/strong>, pods<\/strong>, replicas<\/strong>, Helm values<\/strong>, or kubectl apply<\/strong> \u2192 you\u2019re talking about Docker\/OCI containers<\/strong>.<\/li>\n<\/ul>\n

              A single C4 Container might be deployed as:<\/p>\n

                \n
              • One Docker container<\/li>\n
              • Multiple replicas\/pods<\/li>\n
              • A serverless function invocation<\/li>\n
              • A VM-based process<\/li>\n
              • Even part of a larger monolith JAR\/WAR<\/li>\n<\/ul>\n

                The mapping between C4 Containers and actual runtime containers is many-to-many<\/strong> and belongs in the Deployment Diagram<\/strong> (one of the supporting views covered in Module 5), not the Container Diagram.<\/p>\n

                Why This Distinction Matters<\/h3>\n

                Confusing the two leads to common modeling mistakes:<\/p>\n

                  \n
                • Trying to show pods, replicas, or Kubernetes namespaces in a Level 2 Container Diagram (too low-level)<\/li>\n
                • Drawing one giant \u201cMonolith\u201d container when the monolith actually contains multiple logical deployable units<\/li>\n
                • Over-fragmenting into dozens of tiny containers just because each microservice has its own Docker image<\/li>\n<\/ul>\n

                  By keeping C4 Container<\/strong> as a logical, responsibility-focused boundary, your Level 2 diagrams stay clean, focused, and useful for architecture communication \u2014 while leaving runtime\/deployment details for the right level (Deployment view).<\/p>\n

                  With this clear distinction in mind, you\u2019re now ready to confidently identify and name the real C4 Containers inside your system \u2014 the major moving parts that make everything work.<\/p>\n","protected":false},"featured_media":0,"parent":15065,"menu_order":1,"comment_status":"closed","ping_status":"closed","template":"","doc_tag":[],"class_list":["post-15070","docs","type-docs","status-publish","hentry"],"yoast_head":"\nWhat is a "Container"? - Cybermedian Indian<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.cybermedian.com\/in\/docs\/mastering-c4-model\/module-3-level-2-diving-into-container-diagrams\/what-is-a-container\/\" \/>\n<meta property=\"og:locale\" content=\"hi_IN\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"What is a "Container"? - Cybermedian Indian\" \/>\n<meta property=\"og:description\" content=\"Distinguishing C4 containers from Docker containers One of the most frequent points of confusion when people first encounter the C4\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.cybermedian.com\/in\/docs\/mastering-c4-model\/module-3-level-2-diving-into-container-diagrams\/what-is-a-container\/\" \/>\n<meta property=\"og:site_name\" content=\"Cybermedian Indian\" \/>\n<meta property=\"article:modified_time\" content=\"2026-01-15T03:11:01+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"\u0905\u0928\u0941\u092e\u093e\u0928\u093f\u0924 \u092a\u0922\u093c\u0928\u0947 \u0915\u093e \u0938\u092e\u092f\" \/>\n\t<meta name=\"twitter:data1\" content=\"3 \u092e\u093f\u0928\u091f\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.cybermedian.com\/in\/docs\/mastering-c4-model\/module-3-level-2-diving-into-container-diagrams\/what-is-a-container\/\",\"url\":\"https:\/\/www.cybermedian.com\/in\/docs\/mastering-c4-model\/module-3-level-2-diving-into-container-diagrams\/what-is-a-container\/\",\"name\":\"What is a \\\"Container\\\"? - Cybermedian Indian\",\"isPartOf\":{\"@id\":\"https:\/\/www.cybermedian.com\/in\/#website\"},\"datePublished\":\"2026-01-14T05:45:34+00:00\",\"dateModified\":\"2026-01-15T03:11:01+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/www.cybermedian.com\/in\/docs\/mastering-c4-model\/module-3-level-2-diving-into-container-diagrams\/what-is-a-container\/#breadcrumb\"},\"inLanguage\":\"hi-IN\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.cybermedian.com\/in\/docs\/mastering-c4-model\/module-3-level-2-diving-into-container-diagrams\/what-is-a-container\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.cybermedian.com\/in\/docs\/mastering-c4-model\/module-3-level-2-diving-into-container-diagrams\/what-is-a-container\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.cybermedian.com\/in\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mastering the C4 Model: From Foundations to AI-Powered Software Architecture Visualization\",\"item\":\"https:\/\/www.cybermedian.com\/in\/docs\/mastering-c4-model\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Module 3: Level 2 \u2013 Diving into Container Diagrams\",\"item\":\"https:\/\/www.cybermedian.com\/in\/docs\/mastering-c4-model\/module-3-level-2-diving-into-container-diagrams\/\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"What is a “Container”?\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.cybermedian.com\/in\/#website\",\"url\":\"https:\/\/www.cybermedian.com\/in\/\",\"name\":\"Cybermedian Indian\",\"description\":\"Learning one new thing everyday\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.cybermedian.com\/in\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"hi-IN\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"What is a \"Container\"? - Cybermedian Indian","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.cybermedian.com\/in\/docs\/mastering-c4-model\/module-3-level-2-diving-into-container-diagrams\/what-is-a-container\/","og_locale":"hi_IN","og_type":"article","og_title":"What is a \"Container\"? - Cybermedian Indian","og_description":"Distinguishing C4 containers from Docker containers One of the most frequent points of confusion when people first encounter the C4","og_url":"https:\/\/www.cybermedian.com\/in\/docs\/mastering-c4-model\/module-3-level-2-diving-into-container-diagrams\/what-is-a-container\/","og_site_name":"Cybermedian Indian","article_modified_time":"2026-01-15T03:11:01+00:00","twitter_card":"summary_large_image","twitter_misc":{"\u0905\u0928\u0941\u092e\u093e\u0928\u093f\u0924 \u092a\u0922\u093c\u0928\u0947 \u0915\u093e \u0938\u092e\u092f":"3 \u092e\u093f\u0928\u091f"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/www.cybermedian.com\/in\/docs\/mastering-c4-model\/module-3-level-2-diving-into-container-diagrams\/what-is-a-container\/","url":"https:\/\/www.cybermedian.com\/in\/docs\/mastering-c4-model\/module-3-level-2-diving-into-container-diagrams\/what-is-a-container\/","name":"What is a \"Container\"? - Cybermedian Indian","isPartOf":{"@id":"https:\/\/www.cybermedian.com\/in\/#website"},"datePublished":"2026-01-14T05:45:34+00:00","dateModified":"2026-01-15T03:11:01+00:00","breadcrumb":{"@id":"https:\/\/www.cybermedian.com\/in\/docs\/mastering-c4-model\/module-3-level-2-diving-into-container-diagrams\/what-is-a-container\/#breadcrumb"},"inLanguage":"hi-IN","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.cybermedian.com\/in\/docs\/mastering-c4-model\/module-3-level-2-diving-into-container-diagrams\/what-is-a-container\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.cybermedian.com\/in\/docs\/mastering-c4-model\/module-3-level-2-diving-into-container-diagrams\/what-is-a-container\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.cybermedian.com\/in\/"},{"@type":"ListItem","position":2,"name":"Mastering the C4 Model: From Foundations to AI-Powered Software Architecture Visualization","item":"https:\/\/www.cybermedian.com\/in\/docs\/mastering-c4-model\/"},{"@type":"ListItem","position":3,"name":"Module 3: Level 2 \u2013 Diving into Container Diagrams","item":"https:\/\/www.cybermedian.com\/in\/docs\/mastering-c4-model\/module-3-level-2-diving-into-container-diagrams\/"},{"@type":"ListItem","position":4,"name":"What is a “Container”?"}]},{"@type":"WebSite","@id":"https:\/\/www.cybermedian.com\/in\/#website","url":"https:\/\/www.cybermedian.com\/in\/","name":"Cybermedian Indian","description":"Learning one new thing everyday","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.cybermedian.com\/in\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"hi-IN"}]}},"comment_count":0,"_links":{"self":[{"href":"https:\/\/www.cybermedian.com\/in\/wp-json\/wp\/v2\/docs\/15070","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.cybermedian.com\/in\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/www.cybermedian.com\/in\/wp-json\/wp\/v2\/types\/docs"}],"replies":[{"embeddable":true,"href":"https:\/\/www.cybermedian.com\/in\/wp-json\/wp\/v2\/comments?post=15070"}],"version-history":[{"count":2,"href":"https:\/\/www.cybermedian.com\/in\/wp-json\/wp\/v2\/docs\/15070\/revisions"}],"predecessor-version":[{"id":15114,"href":"https:\/\/www.cybermedian.com\/in\/wp-json\/wp\/v2\/docs\/15070\/revisions\/15114"}],"up":[{"embeddable":true,"href":"https:\/\/www.cybermedian.com\/in\/wp-json\/wp\/v2\/docs\/15065"}],"next":[{"title":"Technology Choices","link":"https:\/\/www.cybermedian.com\/in\/docs\/mastering-c4-model\/module-3-level-2-diving-into-container-diagrams\/technology-choices\/","href":"https:\/\/www.cybermedian.com\/in\/wp-json\/wp\/v2\/docs\/15071"}],"prev":[{"title":"Technical Decomposition","link":"https:\/\/www.cybermedian.com\/in\/docs\/mastering-c4-model\/module-3-level-2-diving-into-container-diagrams\/technical-decomposition\/","href":"https:\/\/www.cybermedian.com\/in\/wp-json\/wp\/v2\/docs\/15069"}],"wp:attachment":[{"href":"https:\/\/www.cybermedian.com\/in\/wp-json\/wp\/v2\/media?parent=15070"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/www.cybermedian.com\/in\/wp-json\/wp\/v2\/doc_tag?post=15070"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}