Deployment Troubleshooting
Common deployment issues and how to resolve them.
Build Failures
Dockerfile Not Found
Error: Build fails with "Dockerfile not found"
Solutions:
- Ensure Dockerfile exists in repository root directory
- Check that Dockerfile is in the correct branch
- Verify Dockerfile name (case-sensitive: must be "Dockerfile")
- Check repository connection is correct
Docker Build Failed
Error: Docker build process fails during execution
Check Build Logs:
- Review build logs for specific error messages
- Common issues: missing dependencies, syntax errors, network issues
- Test Dockerfile locally:
docker build . - Ensure all required files are in repository
Container Startup Issues
Container Port Mismatch
Problem: Application is deployed but not accessible
Solution:
- Verify container_port matches the port your application listens on
- Check Dockerfile EXPOSE directive
- Verify application binds to 0.0.0.0, not 127.0.0.1
- Update container_port in Settings and redeploy
Container Crashing
Problem: Pods start but immediately crash or restart
Debug Steps:
- Check application logs in the Logs tab
- Verify environment variables are set correctly
- Check for missing dependencies or configuration
- Test application locally in Docker container
- Review resource limits (CPU/Memory may be insufficient)
Domain & SSL Issues
SSL Certificate Not Issued
If SSL certificate is not automatically provisioned:
- Verify DNS CNAME record is correctly configured
- Wait for DNS propagation (may take up to 24 hours)
- Check domain is accessible via HTTP first
- Contact support if certificate is not issued within 24 hours