diff --git a/import-ova-pve.py b/unused/import-ova-pve.py
similarity index 89%
rename from import-ova-pve.py
rename to unused/import-ova-pve.py
index a2459d8..d3738f8 100755
--- a/import-ova-pve.py
+++ b/unused/import-ova-pve.py
@@ -1,4 +1,17 @@
 #!/usr/bin/env python3
+#
+# RETIRED. Kept for reference only.
+#
+# Proxmox imports OVA/OVF natively now, via a storage with the "import" content
+# type: upload the .ova there and use Create VM > Import, or `qm importovf`.
+# The built-in path handles disk format conversion per storage type, which this
+# script did not.
+#
+# Two known bugs, left unfixed since the script is retired:
+#   * every VMDK is imported in the loop, but only vm-<vmid>-disk-0 is ever
+#     attached, so multi-disk appliances leave the rest orphaned
+#   * the disk name is assumed to be vm-<vmid>-disk-N, which does not hold on
+#     every storage type
 
 import os
 import sys
diff --git a/import-ova-to-proxmox.sh b/unused/import-ova-to-proxmox.sh
similarity index 91%
rename from import-ova-to-proxmox.sh
rename to unused/import-ova-to-proxmox.sh
index 0234267..4d75e5d 100755
--- a/import-ova-to-proxmox.sh
+++ b/unused/import-ova-to-proxmox.sh
@@ -1,4 +1,16 @@
 #!/bin/bash
+#
+# RETIRED. Kept for reference only.
+#
+# Proxmox imports OVA/OVF natively now, via a storage with the "import" content
+# type: upload the .ova there and use Create VM > Import, or `qm importovf`.
+# The built-in path handles disk format conversion per storage type, which this
+# script did not.
+#
+# Known bug, left unfixed since the script is retired: importdisk is called with
+# --format qcow2 unconditionally, which fails on ZFS and LVM-thin storages that
+# do not take a format argument.
+
 set -euo pipefail
 
 # === OVF/OVA Importer for Proxmox ===