How proxmox/pve-container works
This repository implements Proxmox VE container management over LXC. The documented user workflow uses pct to create, start, enter, stop, and destroy integer-ID containers; management is also exposed through the API. Container configuration is stored on the cluster filesystem. The tree identifies separate modules for lifecycle, snapshots, migration, setup, and backup, but no source excerpts were provided, so their internal calls and several integrations cannot be verified here.
Main entry points: PVE/LXC.pm LXC management · Config.pm Container config · API2/LXC.pm Management API · Setup.pm Guest setup
Components 20
User interfaces
- pct CLI
src/PVE/CLI/pct.pm - Management API
src/PVE/API2/LXC.pm - Config API
src/PVE/API2/LXC/Config.pm - Status API
src/PVE/API2/LXC/Status.pm
Container lifecycle
- LXC management
src/PVE/LXC.pm - Container creation
src/PVE/LXC/Create.pm - Container commands
src/PVE/LXC/Command.pm - Cgroup controls
src/PVE/LXC/CGroup.pm - Namespaces
src/PVE/LXC/Namespaces.pm - Container monitor
src/PVE/LXC/Monitor.pm
Container operations
- Snapshot API
src/PVE/API2/LXC/Snapshot.pm - Migration
src/PVE/LXC/Migrate.pm - Backup integration
src/PVE/VZDump/LXC.pm - Network bridge hook
src/lxcnetaddbr
Configuration and setup
- Container config
src/PVE/LXC/Config.pm - Cluster config files
- Guest setup
src/PVE/LXC/Setup.pm - OS setup plugins
src/PVE/LXC/Setup
Other components
- Operator
- LXC engine
Connections 19
- Operator → pct CLI: runs commands
README - pct CLI → LXC management: manages containers
README - Operator → Management API: uses API
README - Container config → Cluster config files: stored on
README - Management API → Config API: routes config
- Management API → Status API: routes status
- LXC management → Container creation: creates
- LXC management → Container config: uses config
- LXC management → Container commands: dispatches
- LXC management → Cgroup controls: manages limits
- LXC management → Namespaces: configures
- LXC management → Container monitor: monitors
- Snapshot API → Container config: updates snapshots
- Migration → Container config: reads config
- Backup integration → Container config: backs up
- Guest setup → OS setup plugins: selects plugin
- Guest setup → Container creation: configures guest
- LXC management → LXC engine: wraps
- Network bridge hook → LXC engine: integrates with