# pve-tools/pve-tools-9 architecture

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

- Interactive diagram: https://gitdiagram.com/pve-tools/pve-tools-9
- Repository: https://github.com/pve-tools/pve-tools-9

## Overview

PVE Tools Pro is an interactive Bash operations toolbox for Proxmox VE. Users start `PVE-Tools.sh`, choose a menu-driven task, and use domain modules to inspect or change the host, VM/container configuration, networking, storage, or GPU passthrough. Other major capabilities include system maintenance, security and risk controls, diagnostics, and community integrations. The README documents these capabilities, but the sampled source only covers mirror probing; internal dispatch and most module-to-module wiring are therefore not asserted.

Main entry points: [`src/modules/02-sources`](https://github.com/pve-tools/pve-tools-9/tree/main/src/modules/02-sources) (Sources and upgrades), [`src/modules/10-third-party`](https://github.com/pve-tools/pve-tools-9/tree/main/src/modules/10-third-party) (Third-party modules), [`PVE-Tools.sh`](https://github.com/pve-tools/pve-tools-9/blob/main/PVE-Tools.sh) (Interactive launcher), [`src/modules/01-optimization`](https://github.com/pve-tools/pve-tools-9/tree/main/src/modules/01-optimization) (Host optimization)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and runtime"]
  node_entrypoint["Interactive launcher<br/>[PVE-Tools.sh]"]
  node_shellcore["Runtime services"]
end

subgraph group_maintenance["Host maintenance"]
  node_optimizations["Host optimization"]
  node_sources["Sources and upgrades"]
  node_kernel["Boot and kernel"]
  node_hosttools["Tools and diagnostics"]
end

subgraph group_virtualization["VM and GPU operations"]
  node_vmops["VM and container"]
  node_gpupassthrough["GPU passthrough"]
end

subgraph group_infrastructure["Network and storage"]
  node_networking["Host networking"]
  node_storage["Disk and storage"]
end

subgraph group_ecosystem["Security and integrations"]
  node_security["Security controls"]
  node_thirdparty["Third-party modules"]
  node_help["Help and information"]
end

node_operator(("PVE operator"))
node_pvehost["Proxmox host"]
node_externalrepos["External repositories"]
node_community["Community services"]

node_operator -->|"starts"| node_entrypoint
node_entrypoint -->|"uses runtime"| node_shellcore
node_optimizations -->|"tunes host"| node_pvehost
node_sources -->|"checks sources"| node_externalrepos
node_sources -->|"updates system"| node_pvehost
node_kernel -->|"manages boot"| node_pvehost
node_hosttools -->|"inspects host"| node_pvehost
node_vmops -->|"manages guests"| node_pvehost
node_gpupassthrough -->|"configures passthrough"| node_pvehost
node_networking -->|"configures network"| node_pvehost
node_storage -->|"manages storage"| node_pvehost
node_security -->|"hardens host"| node_pvehost
node_thirdparty -.->|"accesses ecosystem"| node_community
node_thirdparty -.->|"retrieves modules"| node_externalrepos
node_help -->|"shows guidance"| node_operator

click node_entrypoint "https://github.com/pve-tools/pve-tools-9/blob/main/PVE-Tools.sh"
click node_shellcore "https://github.com/pve-tools/pve-tools-9/tree/main/lib"
click node_optimizations "https://github.com/pve-tools/pve-tools-9/tree/main/src/modules/01-optimization"
click node_sources "https://github.com/pve-tools/pve-tools-9/tree/main/src/modules/02-sources"
click node_kernel "https://github.com/pve-tools/pve-tools-9/tree/main/src/modules/03-boot-kernel"
click node_hosttools "https://github.com/pve-tools/pve-tools-9/tree/main/src/modules/08-tools-about"
click node_vmops "https://github.com/pve-tools/pve-tools-9/tree/main/src/modules/05-vm-container"
click node_gpupassthrough "https://github.com/pve-tools/pve-tools-9/tree/main/src/modules/04-gpu-passthrough"
click node_networking "https://github.com/pve-tools/pve-tools-9/tree/main/src/modules/06-networking"
click node_storage "https://github.com/pve-tools/pve-tools-9/tree/main/src/modules/07-storage-disk"
click node_security "https://github.com/pve-tools/pve-tools-9/tree/main/src/modules/09-security"
click node_thirdparty "https://github.com/pve-tools/pve-tools-9/tree/main/src/modules/10-third-party"
click node_help "https://github.com/pve-tools/pve-tools-9/tree/main/src/modules/11-help"

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_entrypoint,node_shellcore toneBlue
class node_optimizations,node_sources,node_kernel,node_hosttools toneAmber
class node_vmops,node_gpupassthrough toneMint
class node_networking,node_storage toneRose
class node_security,node_thirdparty,node_help,node_operator,node_pvehost,node_externalrepos,node_community toneIndigo
```

## Components

### Entry and runtime

- [Interactive launcher](https://github.com/pve-tools/pve-tools-9/blob/main/PVE-Tools.sh): `PVE-Tools.sh`
- [Runtime services](https://github.com/pve-tools/pve-tools-9/tree/main/lib): `lib`

### Host maintenance

- [Host optimization](https://github.com/pve-tools/pve-tools-9/tree/main/src/modules/01-optimization): `src/modules/01-optimization`
- [Sources and upgrades](https://github.com/pve-tools/pve-tools-9/tree/main/src/modules/02-sources): `src/modules/02-sources`
- [Boot and kernel](https://github.com/pve-tools/pve-tools-9/tree/main/src/modules/03-boot-kernel): `src/modules/03-boot-kernel`
- [Tools and diagnostics](https://github.com/pve-tools/pve-tools-9/tree/main/src/modules/08-tools-about): `src/modules/08-tools-about`

### VM and GPU operations

- [VM and container](https://github.com/pve-tools/pve-tools-9/tree/main/src/modules/05-vm-container): `src/modules/05-vm-container`
- [GPU passthrough](https://github.com/pve-tools/pve-tools-9/tree/main/src/modules/04-gpu-passthrough): `src/modules/04-gpu-passthrough`

### Network and storage

- [Host networking](https://github.com/pve-tools/pve-tools-9/tree/main/src/modules/06-networking): `src/modules/06-networking`
- [Disk and storage](https://github.com/pve-tools/pve-tools-9/tree/main/src/modules/07-storage-disk): `src/modules/07-storage-disk`

### Security and integrations

- [Security controls](https://github.com/pve-tools/pve-tools-9/tree/main/src/modules/09-security): `src/modules/09-security`
- [Third-party modules](https://github.com/pve-tools/pve-tools-9/tree/main/src/modules/10-third-party): `src/modules/10-third-party`
- [Help and information](https://github.com/pve-tools/pve-tools-9/tree/main/src/modules/11-help): `src/modules/11-help`

### Other components

- **PVE operator**
- **Proxmox host**
- **External repositories**
- **Community services**

## Connections

- PVE operator → Interactive launcher: starts
- Interactive launcher → Runtime services: uses runtime
- Host optimization → Proxmox host: tunes host
- Sources and upgrades → External repositories: checks sources
- Sources and upgrades → Proxmox host: updates system
- Boot and kernel → Proxmox host: manages boot
- Tools and diagnostics → Proxmox host: inspects host
- VM and container → Proxmox host: manages guests
- GPU passthrough → Proxmox host: configures passthrough
- Host networking → Proxmox host: configures network
- Disk and storage → Proxmox host: manages storage
- Security controls → Proxmox host: hardens host
- Third-party modules → Community services: accesses ecosystem
- Third-party modules → External repositories: retrieves modules
- Help and information → PVE operator: shows guidance