PROX004 - Connection Refused By Proxmox

Agent error code #PROX004 indicates that the agent reached the Proxmox host but the connection to the API port was actively refused. Nothing was listening on the address and port in the backend URL.

Common causes include:

• The backend URL points at the wrong port (the Proxmox API listens on 8006 by default)
• The pveproxy service is stopped or has failed on the Proxmox host
• A firewall is rejecting (rather than dropping) connections to the API port
• The backend URL points at the wrong host

Steps to Resolve

Verify the Backend URL

1. In the Knocknoc admin interface, open the backend configuration for the affected Proxmox Knoc
2. Confirm the Hostname is a full URL including scheme and port, e.g. https://pve.example.com:8006

Confirm the API Service Is Running

1. On the Proxmox host, confirm the pveproxy service is active
2. Confirm the host is listening on the API port (default 8006)
3. Confirm no firewall rule is rejecting connections from the agent's source address

For more details, see the Proxmox setup guide.

Still Having Issues?

We can help you out, contact us at [email protected].