diff --git a/docs/hardware/environment.md b/docs/hardware/environment.md
index 934048a..edc84ba 100644
--- a/docs/hardware/environment.md
+++ b/docs/hardware/environment.md
@@ -46,6 +46,7 @@ Five nodes running Proxmox VE:
 
 - **OS:** Ubuntu 24.04 (cloud-init), kernel 6.8.0-100-generic
 - **Resources:** 16 threads, 32GB RAM, 300GB disk
+- **Swap:** 32GB swapfile (`/swapfile`), `vm.swappiness=10` (prefer RAM, swap under pressure only). Provisioned 2026-04-23 to support bursty jobs (gdal_contour, tippecanoe) alongside Docker ML containers.
 - **GPU:** RTX A4000 (passthrough), NVIDIA driver 580.126.09, CUDA 13.0
 - **Software:** Docker 29.2.1 + nvidia-container-toolkit 1.18.2, Node.js 22.22.0, Python 3.12.3
 - **Docker containers:** open-webui (8080), ollama (11434 w/ GPU), qdrant (6333), tei (8090)