{"title":"Troubleshooting","description":"","section":"","version":"v1.5","path":"troubleshooting","canonical_url":"https://amberframework.org/docs/v1.5/troubleshooting","markdown_url":"https://amberframework.org/docs/v1.5/troubleshooting.md","inherited":true,"content_markdown":"# Troubleshooting\n\nThis is a place to share common problems and solutions to them.\n\n## Can't build my amber project\n\nSometimes, you are trying to build an amber 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`.\n\n{% hint style=\"info\" %}\nAlso see [Installation Guide](guides/installation.md)\n{% endhint %}\n\n## Can't connect to database\n\nSometimes, you're trying to run your amber 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/amber db drop create migrate` , before executing your project.\n\n{% hint style=\"info\" %}\nAlso see [Creating the Database](guides/create-new-app.md#creating-the-database)\n{% endhint %}\n\n## Can't update dependencies\n\nOn new [crystal 0.25.0 release](https://crystal-lang.org/2018/06/15/crystal-0.25.0-released.html), the `shards` command has a global cache issue, already reported [here](https://github.com/crystal-lang/shards/issues/211) and fixed on next version. Until crystal 0.25.1 is released, you can fix your dependencies by removing global shards cache and shards files.\n\n```text\nrm -rf ~/.cache/shards\nrm -rf shard.lock\nrm -rf lib\n```\n\n## Something else doesn't work\n\nAsk around on the [Amber Discord](https://discord.gg/vwvP5zakSn), or [create an issue](https://github.com/amberframework/amber/issues).\n\nIf you figure it out, edit this document as a courtesy to the next person having the same problem."}