Skip to content
Alkimist
Browse documentation

Fix a problem

My deployment failed

Find the first error, correct the project setting or repository, and deploy again.

1. Open the failed deployment

Open your project, select Deployments, and choose the newest failed deployment. Start with the first red error. Later messages are often a result of that first failure.

2. Match the error to the fix

What you seeWhat to do
Framework not detectedPush the framework requirement file shown in its guide to the repository root.
Dependency or package not foundAdd it to the framework requirement file and push the change.
Missing environment variableAdd it under Environment Variables, then deploy again.
Migration failedCheck the database resource and test the migration against the same database type.
Health check failedMake sure the configured /up or / path returns HTTP 200 within the 10-second deployment health-check window.

3. Deploy again

Push the correction to the selected branch, return to the project, and choose Deploy. The new deployment keeps its own logs, so you can compare it with the failed attempt.

Still need help?

Contact [email protected] and include the project name, deployment ID, approximate time, and the first error message. Never send passwords, private keys, or full environment-variable values.