Skip to main content

Troubleshooting Guide

Solutions to common Firebase Hosting issues.

Deployment Issues​

"Permission Denied"​

# Solution: Re-authenticate
firebase login
firebase login --reauth

"Deploy Failed"​

  • Check file size limits (2GB max)
  • Verify firebase.json syntax
  • Check total file count (25,000 max)

Domain Issues​

SSL Certificate Pending​

  • Wait up to 24 hours for provisioning
  • Verify DNS records are correct
  • Check DNS propagation globally

Custom Domain Not Working​

# Verify DNS
dig yourdomain.com
nslookup yourdomain.com

Performance Issues​

  • Check cache headers configuration
  • Optimize images and assets
  • Review CDN hit ratio in console

Coming Soon​

This documentation is being expanded. For now, please refer to: