Troubleshooting

Common issues and their solutions.

Content Not Caching

Symptoms

  • X-Cache: MISS on every request
  • Origin receiving all traffic
  • No performance improvement

Solutions

  1. Check Cache-Control Headers

    curl -I https://your-zone.cdn.nordiccdn.com/path

    Look for Cache-Control: private, no-cache, or no-store.

  2. Verify Content-Type Only cacheable content types are stored. Check your origin returns correct MIME types.

  3. Check for Set-Cookie Responses with Set-Cookie headers are not cached by default.

  4. Review Origin Response

    curl -I https://your-origin.com/path

    Compare headers between origin and CDN.

Stale Content Being Served

Symptoms

  • Updated content not showing
  • Old versions appearing
  • Changes not reflected

Solutions

  1. Purge Cache

    curl -X POST "https://nordiccdn.com/api/v1/zones/{uuid}/purge" \
 -H "Authorization: Bearer TOKEN" \
 -d '{"type": "path", "paths": ["/updated-path/"]}'

  2. Use Cache-Busting URLs

    <link href="/style.css?v=2.0" rel="stylesheet">

  3. Check Browser Cache Try incognito mode or clear browser cache.

  4. Verify Purge Completed Check purge status in dashboard or via API.

SSL Certificate Issues

Symptoms

  • "Your connection is not private" error
  • Certificate warnings
  • Mixed content warnings

Solutions

  1. Check DNS Configuration

    dig cdn.yourdomain.com CNAME

    Should point to your CDN hostname.

  2. Wait for Certificate Provisioning New domains can take 1-5 minutes for SSL.

  3. Verify Domain Ownership Ensure DNS changes have propagated.

  4. Check for Mixed Content All resources should use HTTPS:

    <!-- Wrong -->
<img src="http://...">

<!-- Correct -->
<img src="https://...">

Origin Connection Failed

Symptoms

  • 502 Bad Gateway errors
  • 504 Gateway Timeout
  • "Origin unreachable" messages

Solutions

  1. Verify Origin is Up

    curl -I https://your-origin.com

  2. Check Origin Firewall Whitelist NordicCDN edge IP ranges.

  3. Verify Origin URL Check origin URL in zone settings is correct.

  4. Check Origin SSL If origin uses HTTPS, ensure certificate is valid.

  5. Increase Timeout Contact support if origin needs longer response times.

Custom Domain Not Working

Symptoms

  • Domain shows wrong content
  • SSL certificate errors
  • DNS resolution fails

Solutions

  1. Verify CNAME Record

    dig cdn.yourdomain.com CNAME

    Should return your CDN hostname.

  2. Wait for DNS Propagation DNS changes can take up to 48 hours.

  3. Check Domain is Added Verify domain is listed in zone's custom domains.

  4. Clear DNS Cache

    # macOS
sudo dscacheutil -flushcache

# Windows
ipconfig /flushdns

Images Not Optimizing

Symptoms

  • Images not converted to WebP
  • No size reduction
  • Optimization parameters ignored

Solutions

  1. Verify Optimization is Enabled Check zone settings for "Image Optimization".

  2. Check File Format Only supported formats are optimized (JPEG, PNG, WebP, etc.).

  3. Verify URL Parameters

    /image.jpg?width=800&quality=80

  4. Check Response Headers Look for Content-Type: image/webp header.

  5. Clear Cache Purge the image after enabling optimization.

WAF Blocking Legitimate Traffic

Symptoms

  • 403 Forbidden errors
  • Users unable to access site
  • Challenge page appearing unexpectedly

Solutions

  1. Check WAF Rules Review rules in zone firewall settings.

  2. Check Rule Priority Ensure allow rules have lower priority (higher precedence) than block rules.

  3. Add IP to Whitelist Create an allow rule for affected IPs.

  4. Review Rule Hits Check which rules are being triggered.

  5. Use Challenge Instead of Block For uncertain traffic, use challenges instead of blocks.

Waiting Room Not Working

Symptoms

  • Users not being queued
  • Queue page not showing
  • Sessions not being tracked

Solutions

  1. Verify Waiting Room is Enabled Check zone settings.

  2. Check Bypass Rules Ensure user isn't matching bypass IP/path/cookie.

  3. Verify JavaScript is Loading Queue page requires JavaScript for heartbeats.

  4. Check Cookie Settings Ensure cookies are not blocked.

  5. Test with Capacity Reduced Temporarily set max users to 1 to test queuing.

API Errors

401 Unauthorized

  • Verify API token is correct
  • Check token hasn't been revoked
  • Ensure Authorization: Bearer TOKEN header format

422 Validation Error

  • Check required fields are provided
  • Verify field formats (URLs, integers, etc.)
  • Review specific field errors in response

429 Rate Limited

  • Wait for rate limit to reset
  • Implement exponential backoff
  • Reduce request frequency

See API Error Codes for complete reference.

Performance Issues

Slow Response Times

  1. Check Cache Hit Ratio Low hit ratio means requests go to origin.

  2. Verify Edge Location Check X-Edge header is geographically close.

  3. Enable Compression Ensure gzip/brotli compression is enabled.

  4. Optimize Origin Slow origin = slow first request.

High Origin Load

  1. Increase Cache TTL Longer TTL = fewer origin requests.

  2. Review Bypass Rules Too many bypasses increase origin load.

  3. Check for Cache-Busting Random query strings create cache misses.

Getting Help

If you can't resolve an issue:

  1. Check Status Page status.nordiccdn.com for outages.

  2. Gather Information

    • Zone UUID
    • Request URL
    • Response headers
    • Error messages

  3. Contact Support Email: support@nordiccdn.com

Include:

  • Description of the issue
  • Steps to reproduce
  • Expected vs actual behavior
  • Any error messages or screenshots