Frontdoor troubleshooting
This page helps you resolve issues across shares, agents, frontends, environments, and health checks.
Shares and connectivity troubleshooting
| Issue | Troubleshooting steps |
|---|---|
| Share creation failure | Verify the agent and environment are active. Confirm the backend service URL is reachable from the agent's host, and the specified port and protocol are correct. |
| Backend service unreachable | Ensure the backend service is running and responding. Test connectivity directly from the agent's host system to isolate firewall or security group blocks. |
| SSL/TLS issues | For HTTPS backend services, verify certificates are valid on the backend. NetFoundry handles edge SSL termination, but backend configuration is still critical. |
| Authentication problems | Confirm the backend's authentication is configured for public access patterns. Verify tokens or session management work through the public share URL. |
| Performance/slow response | Monitor backend service performance (CPU/memory) and check network latency between the agent and the backend. |
| General diagnostics | 1. Check share status (via API). 2. Test backend directly from agent host. 3. Review agent and backend logs for errors. |
Agent and environment troubleshooting
| Issue | Troubleshooting steps |
|---|---|
| Bootstrap failures | Verify the enrollment token is valid (not expired). Check network connectivity to NetFoundry infrastructure. Review agent logs for specific error messages. |
| Connection/offline status | Verify the Frontdoor agent is running. Check outbound network connectivity on required ports and validate firewall or proxy configurations. Ensure system time is synchronized. |
| Performance issues | Monitor system resources (CPU, memory, network utilization) on the host machine. Consider the agent's placement relative to the backend services to minimize latency. |
| General diagnostics | 1. Check agent status (via API). 2. Validate outbound connectivity to NetFoundry endpoints. 3. Review agent logs. 4. Monitor host system resources. |
Frontend troubleshooting
| Issue | Troubleshooting steps |
|---|---|
| Frontend not available | Verify your account access to the desired frontend type. For custom frontends, ensure DNS is correctly provisioned and configured. |
| SSL certificate issues | For custom frontends, ensure DNS validation records are configured and verify domain ownership and DNS propagation are complete. |
| Access problems | Confirm the correct frontend selection in your share configuration. Verify auth provider configuration is properly set up for custom frontends. |
Health check troubleshooting
| Issue | Troubleshooting steps |
|---|---|
| Health check failures | Verify the target share is active. Confirm the specified endpoint exists and responds correctly. Ensure the expected HTTP response code matches your service's actual response. |
| Timeout issues | Adjust configured timeout values for services with longer processing times. Investigate backend service bottlenecks and consider network latency. |
| Authentication errors | Ensure health check endpoints are secured appropriately but remain accessible to NetFoundry monitoring (avoid complex authentication flows). |
| General diagnostics | 1. Test the share directly (it must work for the health check to succeed). 2. Start with a simple endpoint to isolate configuration issues. 3. Check backend service logs during execution. |