Amber Framework
WebsiteBlogGithubDiscord
  • Introduction
  • Getting Started
  • Guides
    • Overview
    • Installation
    • Create New App
    • Directory Structure
    • Configuration
    • Docker
    • Controllers
      • Sessions
      • Request & Response Objects
      • Halt!
      • Respond With
      • Params
      • Cookies
      • Filters
      • Flash
      • Redirection
      • CSRF
    • Views
      • Basic View Helpers
      • Form Builder
    • Models
      • Granite
        • Granite's README
        • Migrations
        • Validations
        • Callbacks
        • Associations
        • Querying
        • Bulk Insertions
      • Jennifer
        • Jennifer Docs
        • Migrations
        • Models
    • Routing
      • Pipelines
      • Routes
    • Websockets
      • Channels
      • Sockets
      • JavaScript Client
    • Mailers
    • Testing
      • System Tests
  • Deployment
    • Manual Deploy
    • Digital Ocean
    • Heroku
    • Dokku
  • CLI
    • New
    • Recipes
    • Plugins
    • Generate
    • Database
    • Watch
    • Routes
    • Exec
    • Encrypt
  • Examples
    • Amber Auth
    • Crystal Debug
    • Minimal Configuration
  • Cookbook
    • From Scratch
    • Hello World
    • CORS
    • File Download
    • File Upload
    • Cookies
    • Authenticate
    • JSON API
    • JSON Mapping
    • WebSocket Chat
  • Troubleshooting
  • In Production
  • Contributing
  • Code of Conduct
  • HAVE A QUESTION?
    • Join the Discord
    • Follow on Twitter
    • Submit an issue
Powered by GitBook
On this page
  • Can't build my amber project
  • Can't connect to database
  • Can't update dependencies
  • Something else doesn't work

Troubleshooting

PreviousWebSocket ChatNextIn Production

Last updated 2 years ago

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

Can't build my amber project

Sometimes, 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.

Also see

Can't connect to database

Sometimes, 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.

Also see

Can't update dependencies

On new , the shards command has a global cache issue, already reported 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.

rm -rf ~/.cache/shards
rm -rf shard.lock
rm -rf lib

Something else doesn't work

Ask around on the , or .

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

Installation Guide
crystal 0.25.0 release
here
Amber Gitter channel
create an issue
Creating the Database