# immanuel1987/frappe-pilot-docker architecture

> Architecture diagram of the GitHub repository immanuel1987/frappe-pilot-docker, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/immanuel1987/frappe-pilot-docker
- Repository: https://github.com/immanuel1987/frappe-pilot-docker

## Overview

This repository packages Frappe Pilot for deployment on an Amazon Linux EC2 host. The documented workflow is to prepare the host, configure environment values, start the Compose stack, then use Pilot’s setup wizard and serve Frappe sites. The graph reflects documented deployment and persistence relationships; source excerpts were unavailable, so it does not infer internal routing or entrypoint behavior.

Main entry points: [`docker-compose.yml`](https://github.com/immanuel1987/frappe-pilot-docker/blob/main/docker-compose.yml) (Compose stack), [`scripts/setup-amazon-linux-2023.sh`](https://github.com/immanuel1987/frappe-pilot-docker/blob/main/scripts/setup-amazon-linux-2023.sh) (Host installer), [`.env.example`](https://github.com/immanuel1987/frappe-pilot-docker/blob/main/.env.example) (Environment config)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_host_setup["Host setup"]
  node_host_installer["Host installer"]
end

subgraph group_deployment["Container deployment"]
  node_compose_stack["Compose stack<br/>[docker-compose.yml]"]
  node_image_definition["Pilot image"]
  node_environment["Environment config<br/>[.env.example]"]
end

subgraph group_pilot_services["Pilot services"]
  node_pilot["Frappe Pilot<br/>[docker-compose.yml]"]
  node_entrypoint["Container entrypoint"]
  node_mariadb[("MariaDB<br/>[docker-compose.yml]")]
  node_nginx["Site web server config<br/>[nginx-frappe.conf]"]
  node_persistent_data[("Persistent volumes<br/>[docker-compose.yml]")]
end

node_operator(("Operator"))
node_ec2["EC2 host"]
node_pilot_admin["Admin UI / wizard"]
node_frappe_sites["Frappe sites"]

node_operator -->|"connects by SSH"| node_ec2
node_operator -->|"runs installer"| node_host_installer
node_operator -->|"configures"| node_environment
node_operator -->|"starts stack"| node_compose_stack
node_compose_stack -->|"starts service"| node_pilot
node_compose_stack -->|"starts service"| node_mariadb
node_pilot -->|"connects to"| node_mariadb
node_operator -->|"opens setup UI"| node_pilot_admin
node_operator -->|"opens sites"| node_frappe_sites
node_compose_stack -->|"persists bench data"| node_persistent_data

click node_host_installer "https://github.com/immanuel1987/frappe-pilot-docker/blob/main/scripts/setup-amazon-linux-2023.sh"
click node_compose_stack "https://github.com/immanuel1987/frappe-pilot-docker/blob/main/docker-compose.yml"
click node_image_definition "https://github.com/immanuel1987/frappe-pilot-docker/blob/main/Dockerfile"
click node_environment "https://github.com/immanuel1987/frappe-pilot-docker/blob/main/.env.example"
click node_pilot "https://github.com/immanuel1987/frappe-pilot-docker/blob/main/docker-compose.yml"
click node_entrypoint "https://github.com/immanuel1987/frappe-pilot-docker/blob/main/docker/docker-entrypoint.sh"
click node_mariadb "https://github.com/immanuel1987/frappe-pilot-docker/blob/main/docker-compose.yml"
click node_nginx "https://github.com/immanuel1987/frappe-pilot-docker/blob/main/docker/nginx-frappe.conf"
click node_persistent_data "https://github.com/immanuel1987/frappe-pilot-docker/blob/main/docker-compose.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_host_installer,node_pilot_admin toneBlue
class node_compose_stack,node_image_definition,node_environment toneAmber
class node_pilot,node_entrypoint,node_mariadb,node_nginx,node_persistent_data toneMint
class node_operator,node_ec2,node_frappe_sites toneIndigo
```

## Components

### Host setup

- [Host installer](https://github.com/immanuel1987/frappe-pilot-docker/blob/main/scripts/setup-amazon-linux-2023.sh): `scripts/setup-amazon-linux-2023.sh`

### Container deployment

- [Compose stack](https://github.com/immanuel1987/frappe-pilot-docker/blob/main/docker-compose.yml): `docker-compose.yml`
- [Pilot image](https://github.com/immanuel1987/frappe-pilot-docker/blob/main/Dockerfile): `Dockerfile`
- [Environment config](https://github.com/immanuel1987/frappe-pilot-docker/blob/main/.env.example): `.env.example`

### Pilot services

- [Frappe Pilot](https://github.com/immanuel1987/frappe-pilot-docker/blob/main/docker-compose.yml): `docker-compose.yml`
- [Container entrypoint](https://github.com/immanuel1987/frappe-pilot-docker/blob/main/docker/docker-entrypoint.sh): `docker/docker-entrypoint.sh`
- [MariaDB](https://github.com/immanuel1987/frappe-pilot-docker/blob/main/docker-compose.yml): `docker-compose.yml`
- [Site web server config](https://github.com/immanuel1987/frappe-pilot-docker/blob/main/docker/nginx-frappe.conf): `docker/nginx-frappe.conf`
- [Persistent volumes](https://github.com/immanuel1987/frappe-pilot-docker/blob/main/docker-compose.yml): `docker-compose.yml`

### Other components

- **Operator**
- **EC2 host**
- **Admin UI / wizard**
- **Frappe sites**

## Connections

- Operator → EC2 host: connects by SSH (evidence: `README.md`)
- Operator → Host installer: runs installer (evidence: `README.md`)
- Operator → Environment config: configures (evidence: `README.md`)
- Operator → Compose stack: starts stack (evidence: `README.md`)
- Compose stack → Frappe Pilot: starts service (evidence: `README.md`)
- Compose stack → MariaDB: starts service (evidence: `README.md`)
- Frappe Pilot → MariaDB: connects to (evidence: `README.md`)
- Operator → Admin UI / wizard: opens setup UI (evidence: `README.md`)
- Operator → Frappe sites: opens sites (evidence: `README.md`)
- Compose stack → Persistent volumes: persists bench data (evidence: `README.md`)
