PROX005 - Failed To Resolve Proxmox Hostname

Agent error code #PROX005 indicates that the agent could not resolve the Proxmox hostname in the backend URL to an IP address via DNS.

Common causes include:

• A typo in the hostname configured in the Knocknoc backend
• The hostname is internal-only and the agent's resolver cannot see it
• The DNS server the agent uses is unreachable or misconfigured
• The host has no DNS record (only reachable by IP)

Steps to Resolve

Verify the Hostname

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

Confirm Name Resolution From the Agent Host

1. On the host running the Knocknoc agent, confirm the Proxmox hostname resolves
2. If Proxmox is reachable only by IP address, use the IP in the backend URL instead of a name
3. If the name is internal, confirm the agent host uses a DNS resolver that can see it

For more details, see the Proxmox setup guide.

Still Having Issues?

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