Skip to content
Alkimist
Browse documentation
All documentation

Fix a problem

My database or Redis will not connect

Check the managed resource, connection variable, credentials, and migrations.

1. Confirm the resource is running

Open the project and select Resources. Your database or Redis service must show a healthy/running status. If it was just created, wait until setup finishes before redeploying.

2. Use the provided connection variable

Use the connection URL added by Alkimist under Environment Variables. Do not replace its host with localhost, and do not join credentials copied from different resources.

3. Check common messages

  • Connection refused: confirm the resource is running and the application uses the injected host.
  • Authentication failed: remove old credentials and use the current generated URL.
  • Redis AUTH called without a password: use the generated Redis URL exactly instead of adding a password manually.
  • Table does not exist: run the framework's production migrations and redeploy.

4. SQLite projects

Keep the SQLite file on the persistent storage path shown by Alkimist. A file stored only inside the deployed image is replaced during a later deployment.

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.