- 0 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.

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 the complete setup process.