From de65997de49fa40cb5874b5f5cace0732babe6ef Mon Sep 17 00:00:00 2001
From: Pavel Boldyrev <627562+bpg@users.noreply.github.com>
Date: Fri, 28 Mar 2025 10:12:47 -0400
Subject: [PATCH] chore(docs): add known issue for HA VMs and containers in
 README (#1855)

* chore(docs): add known issue for HA VMs and containers in README

Signed-off-by: Pavel Boldyrev <627562+bpg@users.noreply.github.com>
---
 README.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/README.md b/README.md
index e3e2a641..5f4ce516 100644
--- a/README.md
+++ b/README.md
@@ -89,6 +89,12 @@ Work has started to migrate the provider to the new [Terraform Plugin Framework]
 
 ## Known Issues
 
+### HA VMs / containers
+
+If a VM or container resource is created with the provider but managed by an HA cluster, it might be migrated to a different node without the provider being aware of the change.
+This causes a "configuration drift" and the provider will report an error when managing the resource.
+You would need to manually reconcile the resource state stored in the backend to match the actual state of the resource, or remove the resource from the provider management.
+
 ### Disk Images Cannot Be Imported by Non-PAM Accounts
 
 Due to limitations in the Proxmox VE API, certain actions need to be performed using SSH. This requires the use of a PAM account (standard Linux account).