Troubleshooting
Application Won't Start
The build succeeds but the app crashes or never becomes ready.
If the build passes but the application keeps restarting or never reaches Running, the problem is at runtime. Open the Logs tab and watch what happens just after a deployment.
Common Causes
- Not listening on the right address. Your app must bind to
0.0.0.0, notlocalhost, and to the port you exposed in Networking. - A wrong start command. The start command runs as a direct exec, not through a shell.
If you use
&&,$VAR, or pipes, wrap it:sh -c "…". See Build Configuration. - Missing configuration. A crash on boot is often a missing environment variable or database setting. Note that environment changes apply on the next deployment, so use Save & deploy.
- Crashing on startup. Read the runtime logs for the stack trace and fix the error, then redeploy.