Common Issues

Solutions to frequently encountered problems and errors.

Deployment Issues

Build Failed: Dockerfile Not Found

Problem: Docker build fails because Dockerfile is missing or in wrong location.

Solution:

  • Ensure Dockerfile exists in repository root directory
  • Check repository branch is correct
  • Verify Dockerfile has correct name (case-sensitive: Dockerfile, not dockerfile)

Application Not Responding

Problem: Application is deployed but not accessible or returning errors.

Checklist:

  • Verify container port matches application configuration
  • Check application logs for errors
  • Ensure environment variables are set correctly
  • Verify health check endpoint is responding
  • Check DNS configuration for custom domain

Insufficient Balance

Problem: Deployment fails or application stops due to insufficient balance.

Solution:

  • Top up your balance via Top Up page
  • Monitor usage in Billing tab
  • Set up balance alerts (if available)

Performance Issues

Slow Response Times

If your application is responding slowly:

  • Check CPU/Memory usage - upgrade package if hitting limits
  • Review application logs for bottlenecks
  • Ensure proper database connection pooling