Skip to main content

Shares troubleshooting

Get help resolving common share issues.

Share creation failures​

When Share creation fails, verify that your Agent and Environment are active and properly connected to NetFoundry infrastructure. Confirm that the backend service URL is accessible from the Agent's location and check that the specified port and protocol match your service configuration.

Backend service unreachable​

If the public Share URL returns connection errors, ensure your backend service is running and responding on the configured endpoint. Verify that the Agent can reach your backend service by testing connectivity from the Agent's host system, and confirm that no local firewalls or security groups are blocking the connection.

SSL/TLS certificate issues​

For HTTPS backend services, verify that SSL certificates are valid and properly configured on your backend. Note that NetFoundry handles SSL termination at the edge, but backend SSL configuration can still affect connectivity depending on your service requirements.

Authentication problems​

When authentication fails through Shares, confirm that your backend service authentication is configured correctly for public access patterns. Verify that authentication tokens, API keys, or session management work properly when accessed through the public Share URL rather than internal networks.

Performance issues​

For slow Share response times, monitor your backend service performance and resource utilization. Check network latency between the Agent and backend service, and consider implementing Health Checks to monitor service availability and response times consistently.

General diagnostic steps​

  1. Share status verification: Check share status through the management API to verify it's active and properly configured.

  2. Backend service testing: Test your backend service directly from the agent's host system to isolate connectivity issues.

  3. Network connectivity validation: Verify that the agent can communicate with both NetFoundry infrastructure and your backend services.

  4. Log analysis: Review agent logs and backend service logs for error messages and diagnostic information during Share access attempts.