Troubleshooting

Troubleshooting

The common fixes before you ask support.

My app did not deploy

Check the Live Build log first. The usual causes are:

  • missing install or build command
  • app listens on the wrong port
  • required environment variable is missing
  • Dockerfile build fails

If auto-detection picked the wrong stack, set the build settings manually or use a Dockerfile.

My app is running but shows an error

Open App Logs on the project page. Build logs only show deploy output; app logs show what the running container is doing now.

For web apps, make sure the app binds to 0.0.0.0, not localhost.

My app is slow after being idle

That first request may be waking the app from scale-to-zero. After it wakes, the next requests should be normal.

My custom domain is not verified

DNS can take a few minutes to propagate. Re-check that:

  • apex domains use the shown A record
  • subdomains use the shown CNAME
  • the ownership TXT record is present
  • there are no extra proxy or redirect records fighting the setup

My database will not connect

Check whether you are using the private or public connection string.

For public access, enable it and add your client IP to the firewall. An empty allow-list blocks outside connections.

I am out of tokens

Top up from Billing or enable auto top-up. Idle apps that scale to zero stop spending compute tokens until they wake again.