- 3 minutes to read

Deployment Diagram Example

The Deployment diagram shows where containers are hosted and what infrastructure they run on — servers, cloud services, load balancers, network zones, and deployment environments.

See Example C4 Diagrams for an overview of all diagram types and when to use each.

To use this example in Nodinite, copy the Mermaid markup below and follow the Creating Your First C4 Diagram import walkthrough to create a Diagram Set, import the markup, and bind nodes to your Repository.

When to Use

  • Documenting production infrastructure for operations and DevOps teams
  • Planning cloud migrations or hybrid architecture changes
  • Security reviews — identifying network boundaries and data flows across zones
  • Does not show internal container logic — that is in L2 and L3

Full structural support: Infrastructure groupings (Deployment_Node boundaries) are persisted with their boundary type and round-trip correctly through the Mermaid generator — imported Deployment diagrams produce identical output when regenerated.

Example: Order Management System Production Deployment

Preview Mermaid Code
C4Deployment title Order Management System - Production Deployment Deployment_Node(web_browser, "Web Browser", "User Agent") { Container(browser_client, "Browser Client", "Chrome/Firefox/Safari") } Deployment_Node(azure_region, "Azure East US (Production)", "Azure Region") { Deployment_Node(app_service, "App Service Plan", "Azure App Service") { Container(web_app, "Web App", "React.js SPA") Container(order_api, "Order API", "ASP.NET Core") } Deployment_Node(data_tier, "Data Tier", "Azure Virtual Network") { Container(order_db, "Order Database", "Azure SQL Database") Container(redis_cache, "Redis Cache", "Redis") } Deployment_Node(integration_tier, "Integration", "Managed Services") { Container(service_bus, "Service Bus", "Azure Service Bus") } } Deployment_Node(cdn, "Content Delivery Network", "Azure CDN") { Container(static_assets, "Static Assets", "Static files") } Deployment_Node(on_prem, "On-Premises (Hybrid)", "Company Data Center") { Deployment_Node(firewall, "Network DMZ", "Fortinet FortiGate") { Deployment_Node(api_gateway, "API Gateway", "Kong") { Container(api_gateway_container, "API Gateway (container)", "Kong") } } Deployment_Node(warehouse_system, "Warehouse LAN", "Isolated Subnet") { Container(warehouse_erp, "Warehouse ERP", "Legacy monolith") } } Rel(browser_client, static_assets, "HTTPS") Rel(static_assets, api_gateway_container, "HTTPS") Rel(api_gateway_container, order_api, "HTTPS") Rel(web_app, order_api, "HTTPS") Rel(order_api, order_db, "TDS") Rel(order_api, redis_cache, "Redis") Rel(order_api, service_bus, "AMQP") Rel(api_gateway_container, warehouse_erp, "Custom TCP") 
C4Deployment
    title Order Management System - Production Deployment

    Deployment_Node(web_browser, "Web Browser", "User Agent") {
        Container(browser_client, "Browser Client", "Chrome/Firefox/Safari")
    }

    Deployment_Node(azure_region, "Azure East US (Production)", "Azure Region") {
        Deployment_Node(app_service, "App Service Plan", "Azure App Service") {
            Container(web_app, "Web App", "React.js SPA")
            Container(order_api, "Order API", "ASP.NET Core")
        }

        Deployment_Node(data_tier, "Data Tier", "Azure Virtual Network") {
            Container(order_db, "Order Database", "Azure SQL Database")
            Container(redis_cache, "Redis Cache", "Redis")
        }

        Deployment_Node(integration_tier, "Integration", "Managed Services") {
            Container(service_bus, "Service Bus", "Azure Service Bus")
        }
    }

    Deployment_Node(cdn, "Content Delivery Network", "Azure CDN") {
        Container(static_assets, "Static Assets", "Static files")
    }

    Deployment_Node(on_prem, "On-Premises (Hybrid)", "Company Data Center") {
        Deployment_Node(firewall, "Network DMZ", "Fortinet FortiGate") {
            Deployment_Node(api_gateway, "API Gateway", "Kong") {
                Container(api_gateway_container, "API Gateway (container)", "Kong")
            }
        }

        Deployment_Node(warehouse_system, "Warehouse LAN", "Isolated Subnet") {
            Container(warehouse_erp, "Warehouse ERP", "Legacy monolith")
        }
    }

    Rel(browser_client, static_assets, "HTTPS")
    Rel(static_assets, api_gateway_container, "HTTPS")
    Rel(api_gateway_container, order_api, "HTTPS")
    Rel(web_app, order_api, "HTTPS")
    Rel(order_api, order_db, "TDS")
    Rel(order_api, redis_cache, "Redis")
    Rel(order_api, service_bus, "AMQP")
    Rel(api_gateway_container, warehouse_erp, "Custom TCP")

Next Step

Ready to use these diagrams in Nodinite? Creating Your First C4 Diagram walks through creating a Diagram Set, importing Mermaid markup, and binding nodes to your Repository.