Initial commit

skills/terraform/references/proxmox/troubleshooting.md

@@ -0,0 +1,66 @@
+# Proxmox Troubleshooting
+
+## VM Creation Stuck
+
+```
+Timeout waiting for VM to be created
+```
+
+**Causes**: Template missing, storage full, network unreachable
+**Debug**: Check Proxmox task log in web UI
+
+## Clone Failed
+
+```
+VM template not found
+```
+
+**Check**: `qm list | grep template-name`
+**Causes**: Template doesn't exist, wrong node, permission issue
+
+## SSH Timeout
+
+```
+Timeout waiting for SSH
+```
+
+**Debug**:
+1. VM console in Proxmox UI
+2. `cloud-init status` on VM
+3. `ip addr` to verify network
+
+**Causes**: Cloud-init failed, network misconfigured, firewall
+
+## State Drift
+
+```
+Plan shows changes for unchanged resources
+```
+
+**Causes**: Manual changes in Proxmox UI, provider bug
+**Fix**:
+```bash
+terraform refresh
+terraform plan  # Verify
+```
+
+## API Errors
+
+```
+500 Internal Server Error
+```
+
+**Causes**: Invalid config, resource constraints, API timeout
+**Debug**: Check `/var/log/pveproxy/access.log` on Proxmox node
+
+## Permission Denied
+
+```
+Permission check failed
+```
+
+**Fix**: Verify API token has required permissions:
+```bash
+pveum acl list
+pveum user permissions terraform@pve
+```