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.

Also see Installation Guide

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.

Also see Creating the Database

Something else doesn't work

Ask around on the Maze Gitter channel, or create an issue.

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