Skip to main content
All CollectionsTroubleshooting
How can I troubleshoot connection issues with the hiveNet Agent Network?
How can I troubleshoot connection issues with the hiveNet Agent Network?

Follow this guide if your contribution is not working due to networking issues.

Thanasis Karavasilis avatar
Written by Thanasis Karavasilis
Updated over a week ago

The hiveNet agent uses various methods to establish a connection, including UPnP and static port forwarding. If the agent detects stricter NAT configurations, it will attempt different methods for establishing a connection.

The hiveNet Agent uses the following ports:

Port

Protocol

Used for

4443

TCP

Control Plane

4001

TCP

Data Plane

Steps to troubleshoot

Check Local Network Connection

  • Verify that the machine hosting the hiveNet agent has an active and stable internet connection.

Verify Agent Status

  • Ensure the hiveNet agent service is running without errors.

Check the UPnP Status on the Router

  • If UPnP is disabled or unavailable, the hiveNet agent may fail to establish connectivity.

Static Port Forwarding

  • Forward ports 4001 and 4443 from your router to the machine hosting the hiveNet agent.

    1. Log in to your router's admin panel.

    2. Locate the "Port Forwarding" section.

    3. Add a new entry: Forward TCP ports 4001 and 4443 to your machine's local IP.

    4. Save changes and restart the router if needed.

Check Firewall Rules

  • Ensure your firewall allows incoming and outgoing connections on TCP ports 4001 and 4443.

Test Connection

  • Use networking tools like Netstat or Telnet to verify that the ports are accessible outside your network.

Check Logs

  • Inspect hiveNet agent logs for any error messages or warnings related to networking.

Please consult the hiveNet documentation or contact technical support for advanced configurations or persistent issues.

Did this answer your question?