# community-scripts/proxmoxve architecture

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

- Interactive diagram: https://gitdiagram.com/community-scripts/proxmoxve
- Repository: https://github.com/community-scripts/proxmoxve

## Overview

This repository supplies canonical Proxmox VE scripts for installing applications in containers and VMs, plus host utilities. The documented main workflow starts with a user selecting a script, running it on the Proxmox host, and following the shared external core engine; container scripts have corresponding install scripts. The README also documents container update commands and separate VM, host-tooling, and TurnKey capabilities. No source excerpts were provided, so relationships below rely only on README statements.

Main entry points: [`ct`](https://github.com/community-scripts/proxmoxve/tree/main/ct) (Container scripts), [`install`](https://github.com/community-scripts/proxmoxve/tree/main/install) (Install scripts), [`vm`](https://github.com/community-scripts/proxmoxve/tree/main/vm) (VM scripts), [`tools/pve`](https://github.com/community-scripts/proxmoxve/tree/main/tools/pve) (Host tooling)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_install["Application installs"]
  node_ctscripts["Container scripts"]
  node_installscripts["Install scripts"]
  node_core["Shared core engine"]
end

subgraph group_runtime["Host and VM"]
  node_container["Configured container"]
  node_vmscripts["VM scripts"]
  node_vm["Configured VM"]
end

subgraph group_maintenance["Operations"]
  node_updater["Container updater"]
  node_hosttools["Host tooling"]
  node_turnkey["TurnKey helper"]
end

node_user(("Script user"))
node_website["Script website"]
node_host["Proxmox host"]

node_user -->|"selects service"| node_website
node_website -->|"provides command"| node_user
node_user -->|"runs command"| node_host
node_host -->|"runs script"| node_ctscripts
node_ctscripts -->|"loads engine"| node_core
node_ctscripts -->|"uses install half"| node_installscripts
node_core -->|"creates container"| node_container
node_installscripts -->|"installs application"| node_container
node_container -.->|"runs update command"| node_updater
node_host -->|"runs script"| node_vmscripts
node_vmscripts -->|"uses engine"| node_core
node_core -->|"creates VM"| node_vm
node_host -->|"uses tooling"| node_hosttools
node_host -->|"uses helper"| node_turnkey

click node_ctscripts "https://github.com/community-scripts/proxmoxve/tree/main/ct"
click node_installscripts "https://github.com/community-scripts/proxmoxve/tree/main/install"
click node_updater "https://github.com/community-scripts/proxmoxve/tree/main/install"
click node_vmscripts "https://github.com/community-scripts/proxmoxve/tree/main/vm"
click node_hosttools "https://github.com/community-scripts/proxmoxve/tree/main/tools/pve"
click node_turnkey "https://github.com/community-scripts/proxmoxve/tree/main/turnkey"

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_ctscripts,node_installscripts,node_core,node_user toneBlue
class node_container,node_vmscripts,node_vm toneAmber
class node_updater,node_hosttools,node_turnkey toneMint
class node_website,node_host toneIndigo
```

## Components

### Application installs

- [Container scripts](https://github.com/community-scripts/proxmoxve/tree/main/ct): `ct`
- [Install scripts](https://github.com/community-scripts/proxmoxve/tree/main/install): `install`
- **Shared core engine**

### Host and VM

- **Configured container**
- [VM scripts](https://github.com/community-scripts/proxmoxve/tree/main/vm): `vm`
- **Configured VM**

### Operations

- [Container updater](https://github.com/community-scripts/proxmoxve/tree/main/install): `install`
- [Host tooling](https://github.com/community-scripts/proxmoxve/tree/main/tools/pve): `tools/pve`
- [TurnKey helper](https://github.com/community-scripts/proxmoxve/tree/main/turnkey): `turnkey`

### Other components

- **Script user**
- **Script website**
- **Proxmox host**

## Connections

- Script user → Script website: selects service (evidence: `README.md`)
- Script website → Script user: provides command (evidence: `README.md`)
- Script user → Proxmox host: runs command (evidence: `README.md`)
- Proxmox host → Container scripts: runs script (evidence: `README.md`)
- Container scripts → Shared core engine: loads engine (evidence: `README.md`)
- Container scripts → Install scripts: uses install half (evidence: `README.md`)
- Shared core engine → Configured container: creates container (evidence: `README.md`)
- Install scripts → Configured container: installs application (evidence: `README.md`)
- Configured container → Container updater: runs update command (evidence: `README.md`)
- Proxmox host → VM scripts: runs script (evidence: `README.md`)
- VM scripts → Shared core engine: uses engine (evidence: `README.md`)
- Shared core engine → Configured VM: creates VM (evidence: `README.md`)
- Proxmox host → Host tooling: uses tooling (evidence: `README.md`)
- Proxmox host → TurnKey helper: uses helper (evidence: `README.md`)
