> For the complete documentation index, see [llms.txt](https://mazeframework.gitbook.io/maze/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mazeframework.gitbook.io/maze/troubleshooting.md).

# Troubleshooting

This is a place to share common problems and solutions to them.

## Can't build my maze project

Sometimes, you are trying to build an maze project in a new machine and crystal doesn't have all dependencies required by default. Then, ensure to install all development packages for `openssl` `git`, `yaml`, `libevent`, and `sqlite3`, `postgresql`, or `mysql`.

{% hint style="info" %}
Also see [Installation Guide](/maze/guides/installation.md)
{% endhint %}

## Can't connect to database

Sometimes, you're trying to run your maze project and you get an database connection error. Then, ensure your database is running and the `database_url` is well specified on `config/environments/{your-enviroment-file}.yml`, or on `DATABASE_URL` environment variable. Also remember to run `bin/maze db drop create migrate` , before executing your project.

{% hint style="info" %}
Also see [Creating the Database](/maze/guides/create-new-app.md#creating-the-database)
{% endhint %}

## Something else doesn't work

Ask around on the [Maze Gitter channel](https://gitter.im/mazeframework/maze), or [create an issue](https://github.com/mazeframework/maze/issues).

If you figure it out, edit this document as a courtesy to the next person having the same problem.