25 chapters · PDF + EPUB in production

The Proxmox Book

Architecture, Clustering, Workloads, Storage, and Production Operations.

Coming soon

Proxmox VE treated as a control system rather than a checklist of buttons: a replicated configuration filesystem, API front ends and privileged workers, a cluster with quorum and an HA state machine, QEMU and LXC workloads, the storage plugin model with ZFS, LVM, and Ceph, SDN and the firewall, and the operations that keep it all running. Every explanation is grounded in a pinned Proxmox VE and Backup Server source corpus, so a runbook survives the next upgrade.

By Wolfgang Kerschbaumer

Status: all 25 chapters and 4 appendices are drafted and fact-checked against a pinned Proxmox VE 9.2 and Backup Server 4.2 source corpus (about 55,000 words). Verification and final production are underway.

First edition ships DRM-free as PDF and EPUB, with free updates.

01 Contents

From the control plane to production operations.

Architecture and the configuration authority, the cluster and the HA state machine, VM and container workloads, storage and data protection, networking and security, and production operations. Expand a part to see its chapters.

Preface

What this book assumes, and how to read it

Part 1 Architecture and Control Plane 4 chapters
  • 1 The PVE System Model
  • 2 Configuration Authority
  • 3 API Schemas and Worker Tasks
  • 4 Node Services and Task State
Part 2 Cluster and Availability 4 chapters
  • 5 pmxcfs and Corosync
  • 6 Quorum and Membership
  • 7 The HA State Machine
  • 8 Migration and Maintenance
Part 3 Virtual Machines and Containers 4 chapters
  • 9 QEMU Virtual Machine Lifecycle
  • 10 Virtual Machine Resources and Devices
  • 11 LXC Lifecycle and Isolation
  • 12 Images, Templates, Clones, and Cloud-Init
Part 4 Storage and Data Protection 5 chapters
  • 13 The Storage Plugin Model
  • 14 ZFS, LVM, and Ceph Storage
  • 15 Snapshots and Storage Replication
  • 16 Backup and Restore
  • 17 Proxmox Backup Server: Data Plane and Lifecycle
Part 5 Networking and Security 4 chapters
  • 18 Linux Networking: Configuration, Staging, and Live State
  • 19 SDN Zones, Virtual Networks, and Routed Fabrics
  • 20 Firewall Engines, Policy Compilation, and Runtime Proof
  • 21 Identity, RBAC, API Tokens, and TLS Certificates
Part 6 Production Operations 4 chapters
  • 22 Installation, Boot Ownership, and Upgrade Safety
  • 23 Observability and Performance Diagnosis
  • 24 API, CLI, and Reliable Automation
  • 25 Failure Diagnosis and Controlled Recovery
Part 7 Appendices 4 appendices
  • A Command and API Crosswalk
  • B Side-Effect-Aware Diagnostic Runbook
  • C Sources, Reproducibility, and Verification
  • D Glossary and Subject Index
02 Who it's for

For engineers who run Proxmox in production.

Written for operators and platform engineers who already run Proxmox VE and want to predict what each component does. It assumes Linux comfort and picks up where the getting-started guides stop.

Written for
  • Operators who run Proxmox VE clusters and need to know which authority accepted a request and which node owns the object.
  • Teams who debug cluster, storage, and network problems with evidence and runbooks instead of random restarts.
  • Engineers moving from single nodes to clustered, high-availability deployments with Ceph, SDN, and the firewall.

Coming soon.

The manuscript is written and the book is in production. Leave your email and you will get one message when it ships, plus a note as soon as a sample chapter is public.

First edition: DRM-free PDF + EPUB · free updates · published by Sysinit Press.

Get notified when the book ships.

The book is grounded in the Proxmox VE 9.2 and Backup Server 4.2 source corpus. We send only chapter and edition updates.

We use double opt-in and do not track you. Every message includes an unsubscribe link.

If you're running Proxmox clusters, storage, or networking for a team, talk to us. This is the work we do every day.