Skip to main content

PROX002 - Proxmox Did Not Respond In Time

Agent error code #PROX002 indicates that the agent connected to Proxmox VE but the cluster did not return a response before the request timed out.

Common causes include:

  • The Proxmox host is under heavy load and is slow to answer API requests
  • A firewall or network device is silently dropping packets between the agent and Proxmox
  • The agent is reaching Proxmox over a slow or congested link (e.g. a saturated VPN tunnel)
  • The Proxmox API service (pveproxy) is restarting or unhealthy

Steps to Resolve

Confirm Proxmox Is Reachable and Responsive

  1. From the host running the Knocknoc agent, open the Proxmox web UI URL configured in the backend
  2. Confirm it loads promptly. If it is slow in a browser, the agent will see the same delay
  3. Check the Proxmox host load and the status of the pveproxy service

Check the Network Path

  1. Confirm there is no firewall dropping traffic between the agent and the Proxmox API port (default 8006)
  2. If the agent reaches Proxmox over a VPN or WAN link, confirm the link is healthy and not saturated

For more details, see the Proxmox setup guide.

Back to top