# edgexfoundry/edgex-compose architecture

> Architecture diagram of the GitHub repository edgexfoundry/edgex-compose, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/edgexfoundry/edgex-compose
- Repository: https://github.com/edgexfoundry/edgex-compose

## Overview

This repository packages EdgeX Docker Compose deployments rather than implementing the EdgeX services themselves. The main workflow is an operator selecting a generated compose variant and starting an EdgeX stack; variants cover secure or non-secure operation, ARM64, and an optional Sample application. A separate OpenZiti stack is started before the zero-trust deployment. The README documents these roles, but no source excerpts were supplied, so edges are limited to those documented relationships.

Main entry points: [`docker-compose-with-app-sample.yml`](https://github.com/edgexfoundry/edgex-compose/blob/main/docker-compose-with-app-sample.yml) (Sample App Stack), [`docker-compose-no-secty-with-app-sample.yml`](https://github.com/edgexfoundry/edgex-compose/blob/main/docker-compose-no-secty-with-app-sample.yml) (Non-secure Sample), [`docker-compose.yml`](https://github.com/edgexfoundry/edgex-compose/blob/main/docker-compose.yml) (Device Services), [`docker-compose-no-secty.yml`](https://github.com/edgexfoundry/edgex-compose/blob/main/docker-compose-no-secty.yml) (Non-secure Stack)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_deployments["EdgeX Deployments"]
  node_secure_stack["Secure Stack<br/>[docker-compose.yml]"]
  node_secure_arm["Secure ARM64"]
  node_plain_stack["Non-secure Stack"]
  node_sample_stack["Sample App Stack"]
  node_plain_sample["Non-secure Sample"]
  node_devices["Device Services<br/>[docker-compose.yml]"]
  node_ui["EdgeX UI<br/>[docker-compose.yml]"]
  node_sample_app["Sample Application"]
end

subgraph group_zero_trust["Zero Trust"]
  node_openziti["OpenZiti Stack"]
  node_zt_stack["Zero-trust Stack"]
end

node_operator(("Operator"))

node_operator -->|"starts"| node_secure_stack
node_operator -->|"starts"| node_secure_arm
node_operator -->|"starts"| node_plain_stack
node_operator -->|"starts"| node_sample_stack
node_operator -->|"starts"| node_plain_sample
node_secure_stack -->|"includes"| node_devices
node_secure_stack -->|"includes"| node_ui
node_plain_stack -->|"includes"| node_devices
node_plain_stack -->|"includes"| node_ui
node_sample_stack -->|"includes"| node_devices
node_sample_stack -->|"includes"| node_ui
node_sample_stack -->|"includes"| node_sample_app
node_plain_sample -->|"includes"| node_devices
node_plain_sample -->|"includes"| node_ui
node_plain_sample -->|"includes"| node_sample_app
node_operator -->|"starts first"| node_openziti
node_operator -->|"starts"| node_zt_stack
node_openziti -->|"precedes"| node_zt_stack

click node_secure_stack "https://github.com/edgexfoundry/edgex-compose/blob/main/docker-compose.yml"
click node_secure_arm "https://github.com/edgexfoundry/edgex-compose/blob/main/docker-compose-arm64.yml"
click node_plain_stack "https://github.com/edgexfoundry/edgex-compose/blob/main/docker-compose-no-secty.yml"
click node_sample_stack "https://github.com/edgexfoundry/edgex-compose/blob/main/docker-compose-with-app-sample.yml"
click node_plain_sample "https://github.com/edgexfoundry/edgex-compose/blob/main/docker-compose-no-secty-with-app-sample.yml"
click node_devices "https://github.com/edgexfoundry/edgex-compose/blob/main/docker-compose.yml"
click node_ui "https://github.com/edgexfoundry/edgex-compose/blob/main/docker-compose.yml"
click node_sample_app "https://github.com/edgexfoundry/edgex-compose/blob/main/docker-compose-with-app-sample.yml"
click node_openziti "https://github.com/edgexfoundry/edgex-compose/blob/main/docker-compose-openziti.yml"
click node_zt_stack "https://github.com/edgexfoundry/edgex-compose/blob/main/docker-compose-zero-trust.yml"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_secure_stack,node_secure_arm,node_plain_stack,node_sample_stack,node_plain_sample,node_devices,node_ui,node_sample_app toneBlue
class node_openziti,node_zt_stack toneAmber
class node_operator toneIndigo
```

## Components

### EdgeX Deployments

- [Secure Stack](https://github.com/edgexfoundry/edgex-compose/blob/main/docker-compose.yml): `docker-compose.yml`
- [Secure ARM64](https://github.com/edgexfoundry/edgex-compose/blob/main/docker-compose-arm64.yml): `docker-compose-arm64.yml`
- [Non-secure Stack](https://github.com/edgexfoundry/edgex-compose/blob/main/docker-compose-no-secty.yml): `docker-compose-no-secty.yml`
- [Sample App Stack](https://github.com/edgexfoundry/edgex-compose/blob/main/docker-compose-with-app-sample.yml): `docker-compose-with-app-sample.yml`
- [Non-secure Sample](https://github.com/edgexfoundry/edgex-compose/blob/main/docker-compose-no-secty-with-app-sample.yml): `docker-compose-no-secty-with-app-sample.yml`
- [Device Services](https://github.com/edgexfoundry/edgex-compose/blob/main/docker-compose.yml): `docker-compose.yml`
- [EdgeX UI](https://github.com/edgexfoundry/edgex-compose/blob/main/docker-compose.yml): `docker-compose.yml`
- [Sample Application](https://github.com/edgexfoundry/edgex-compose/blob/main/docker-compose-with-app-sample.yml): `docker-compose-with-app-sample.yml`

### Zero Trust

- [OpenZiti Stack](https://github.com/edgexfoundry/edgex-compose/blob/main/docker-compose-openziti.yml): `docker-compose-openziti.yml`
- [Zero-trust Stack](https://github.com/edgexfoundry/edgex-compose/blob/main/docker-compose-zero-trust.yml): `docker-compose-zero-trust.yml`

### Other components

- **Operator**

## Connections

- Operator → Secure Stack: starts (evidence: `README.md`)
- Operator → Secure ARM64: starts (evidence: `README.md`)
- Operator → Non-secure Stack: starts (evidence: `README.md`)
- Operator → Sample App Stack: starts (evidence: `README.md`)
- Operator → Non-secure Sample: starts (evidence: `README.md`)
- Secure Stack → Device Services: includes (evidence: `README.md`)
- Secure Stack → EdgeX UI: includes (evidence: `README.md`)
- Non-secure Stack → Device Services: includes (evidence: `README.md`)
- Non-secure Stack → EdgeX UI: includes (evidence: `README.md`)
- Sample App Stack → Device Services: includes (evidence: `README.md`)
- Sample App Stack → EdgeX UI: includes (evidence: `README.md`)
- Sample App Stack → Sample Application: includes (evidence: `README.md`)
- Non-secure Sample → Device Services: includes (evidence: `README.md`)
- Non-secure Sample → EdgeX UI: includes (evidence: `README.md`)
- Non-secure Sample → Sample Application: includes (evidence: `README.md`)
- Operator → OpenZiti Stack: starts first (evidence: `README.md`)
- Operator → Zero-trust Stack: starts (evidence: `README.md`)
- OpenZiti Stack → Zero-trust Stack: precedes (evidence: `README.md`)
