class AmberCLI::Documentation::Troubleshooting

• AmberCLI::Documentation::Troubleshooting
• Reference
• Object

Overview

Troubleshooting

Common issues and their solutions.

Database Connection Issues

Problem: Connection unsuccessful error Solution:

1. Verify database server is running
2. Check connection string in environment configuration
3. Ensure database exists (run amber database create)

Generation Failures

Problem: Template not found errors Solution:

1. Verify template files exist in expected locations
2. Check generator configuration syntax
3. Ensure template variables are properly defined

Watch Mode Issues

Problem: Files not being watched Solution:

1. Check file patterns in .amber.yml
2. Verify files exist in specified directories
3. Use amber watch --info to see current configuration

Build Failures

Problem: Crystal compilation errors Solution:

1. Run shards install to ensure dependencies are installed
2. Check for syntax errors in generated files
3. Verify all required files are present

Plugin Issues

Problem: Plugin not found or loading errors Solution:

1. Verify plugin is properly installed
2. Check shard.yml dependencies
3. Ensure plugin is compatible with current Amber version

Getting More Help

• Check the Amber Framework documentation
• Join the Crystal community
• Report issues on GitHub

Defined in:

amber_cli/documentation.cr