Troubleshooting Cloudflare connections

Get assistance on troubleshooting Cloudflare connections and connection-related issues, including Cloudflare error pages and site DNS setting problems.

If you experience connection-related issues with your web site when Cloudflare is enabled, this article provides information you can use to troubleshoot and help determine the cause.

📘

Note

For information about how to activate Cloudflare for your account, please see this article. For detailed information about how to configure Cloudflare settings, please see the
Cloudflare documentation.

Cloudflare error pages

One of the most common (and visible) indications of a problem is when your site displays a Cloudflare error page instead of your own content. These error pages can provide valuable information about why your site is not loading correctly.

There are several scenarios where Cloudflare displays an error page:

Site DNS settings

For Cloudflare to work, your domain's nameserver settings must be configured to route traffic through their network.

📘

Note

  • If your site experiences connection issues and it has been less than 24 hours since you enabled Cloudflare, please be patient. It can take up to 24 hours for DNS propagation to complete.

  • If you receive a blank page in your browser (sometimes referred to as the "white screen of death"), this indicates a problem with your site's web application or the web server itself—Cloudflare is not the cause.

To verify that your site is configured at the DNS level to use the Cloudflare network, follow these steps:

  1. Log in to your account using SSH.

  2. At the command prompt, type the following command. Replace example.com with your own domain name:

    dig www.example.com
    
  3. In the dig command output, look under AUTHORITY SECTION:

    • If a hostname with cloudflare.com is included in the response, go to step 4. (For example, dns.cloudflare.com or ns.cloudflare.com )

    • If cloudflare.com is not included in the response, your domain's DNS is not configured to use Cloudflare.

  4. On your local computer, use dig or nslookup to query www.example.com, where example.com represents your domain name.

    📘

    Note

    For information about how to use dig or nslookup on your own computer, please see this article.

    • If a hostname with cloudflare.com is included in the response, then your domain's DNS settings are working along the entire connection path from your local computer to Cloudflare to the server.

    • If cloudflare.com is not included in the response, the problem is not with Cloudflare. Your local computer or network may have a configuration issue preventing access to the Cloudflare network or your site.

More Information

For more information about Cloudflare, please visit https://www.cloudflare.com.

Related Articles