Troubleshooting Guide

This section helps you diagnose and resolve common issues with Arches.

Common Issues

Development Issues

• Build failures
• Code generation problems
• Database connection issues
• Docker setup problems

Debugging Guide

• Using the TUI for debugging
• Log analysis techniques
• Performance profiling
• Network troubleshooting

Quick Fixes

Build Issues

Code
 
# Clean and regenerate everything
make clean-generated
make generate
make build

Database Issues

Code
 
# Reset database
make migrate-reset
make migrate-up

Docker Issues

Code
 
# Clean Docker resources
make docs-clean
docker system prune

Getting Help

1. Check the logs first
2. Review the Architecture Documentation
3. Check Development Setup
4. Open an issue on GitHub

Detailed troubleshooting guides are coming in upcoming iterations.