Home ci 26. errors: DNS HOSTNAME NOT FOUND

26. errors: DNS HOSTNAME NOT FOUND

Last updated on Aug 05, 2025

DNS_HOSTNAME_NOT_FOUND

The DNS_HOSTNAME_NOT_FOUND error occurs when there's an NXDOMAIN error during DNS resolution while attempting to connect to a private IP from an external source. This indicates that the domain being requested does not exist.

Table of Contents

  1. Understanding DNS_HOSTNAME_NOT_FOUND
  2. Troubleshooting Steps
  3. Further Assistance

Understanding DNS_HOSTNAME_NOT_FOUND

The DNS_HOSTNAME_NOT_FOUND error is a DNS-related issue that can occur when:

  • A domain name is mistyped or incorrect.
  • The domain does not exist in the DNS records.

This error typically results in an NXDOMAIN response, indicating that the domain cannot be resolved.


Troubleshooting Steps

  1. Review DNS Configuration:

    • Ensure the domain being requested is correctly configured in your DNS settings.
    • Verify that the domain name matches exactly as it was registered.
  2. Verify Domain Registration:

    • Check if the domain has been properly registered and is active.
    • Contact the domain registrar if you suspect a registration issue.
  3. Check for Private IP Addresses:

    • Ensure that the request is not attempting to connect to a private IP address from an external source.
    • Use an online tool to check if the IP address is publicly accessible.
  4. Review Application Logs:

    • Inspect application logs for any warnings or errors related to DNS resolution issues.
    • Look for specific error messages that might provide additional context.

Further Assistance

If you're still unable to resolve the issue, consider the following steps:

  • Use an online DNS checker to verify domain existence.
  • Contact your network administrator for further assistance with DNS configuration.
  • Check if the domain is associated with a private registry or restricted access.

For more information on error codes and troubleshooting, visit the Error Codes page.


Last updated: July 24, 2024

Related errors:

  • DNS_HOSTNAME_EMPTY
  • DNS_HOSTNAME_RESOLVE_FAILED