# tteck/proxmox architecture

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

- Interactive diagram: https://gitdiagram.com/tteck/proxmox
- Repository: https://github.com/tteck/proxmox

## Overview

Proxmox VE Helper-Scripts is a collection of interactive scripts for creating Linux containers and virtual machines. The documented workflow lets users choose simple or advanced options, then collects and validates those choices to produce the final configuration. The tree separates container templates, VM scripts, and application installation scripts; it also contains host-maintenance and backup utilities. No source excerpts were provided, so the graph shows only relationships explicitly documented in the README and does not infer calls between script directories.

Main entry points: [`ct`](https://github.com/tteck/proxmox/tree/main/ct) (Container scripts), [`vm`](https://github.com/tteck/proxmox/tree/main/vm) (VM scripts)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_creation["Environment Creation"]
  node_ct_scripts["Container scripts"]
  node_vm_scripts["VM scripts"]
  node_choices["Setup choices"]
  node_configuration["Final configuration"]
end

subgraph group_apps["Application Scripts"]
  node_install_scripts["App installers"]
  node_turnkey_scripts["TurnKey scripts"]
end

subgraph group_operations["Host Operations"]
  node_misc_tools["Maintenance tools"]
end

node_user(("Proxmox user"))

node_user -->|"starts interactively"| node_ct_scripts
node_user -->|"starts interactively"| node_vm_scripts
node_user -->|"selects options"| node_choices
node_choices -->|"validated into"| node_configuration

click node_ct_scripts "https://github.com/tteck/proxmox/tree/main/ct"
click node_vm_scripts "https://github.com/tteck/proxmox/tree/main/vm"
click node_install_scripts "https://github.com/tteck/proxmox/tree/main/install"
click node_misc_tools "https://github.com/tteck/proxmox/tree/main/misc"
click node_turnkey_scripts "https://github.com/tteck/proxmox/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_ct_scripts,node_vm_scripts,node_choices,node_configuration,node_user toneBlue
class node_install_scripts,node_turnkey_scripts toneAmber
class node_misc_tools toneMint
```

## Components

### Environment Creation

- [Container scripts](https://github.com/tteck/proxmox/tree/main/ct): `ct`
- [VM scripts](https://github.com/tteck/proxmox/tree/main/vm): `vm`
- **Setup choices**
- **Final configuration**

### Application Scripts

- [App installers](https://github.com/tteck/proxmox/tree/main/install): `install`
- [TurnKey scripts](https://github.com/tteck/proxmox/tree/main/turnkey): `turnkey`

### Host Operations

- [Maintenance tools](https://github.com/tteck/proxmox/tree/main/misc): `misc`

### Other components

- **Proxmox user**

## Connections

- Proxmox user → Container scripts: starts interactively (evidence: `README.md`)
- Proxmox user → VM scripts: starts interactively (evidence: `README.md`)
- Proxmox user → Setup choices: selects options (evidence: `README.md`)
- Setup choices → Final configuration: validated into (evidence: `README.md`)
