Troubleshooting Guide
Solutions to common capysquash issues and error messages
TROUBLESHOOTING GUIDE
Comprehensive solutions to common issues when using CAPYSQUASH.
💡 All examples use capysquash. You can use pgsquash instead - both commands work identically.
QUICK DIAGNOSTICS
# Verify CAPYSQUASH is installed
capysquash --version
# Check Docker is running
docker ps
# Test basic functionality
capysquash init-config# Check PATH
which capysquash
# Check permissions
ls -l $(which capysquash)
# Check Docker connection
docker infoINSTALLATION ISSUES
DOCKER ISSUES
PARSING ERRORS
VALIDATION ERRORS
PERFORMANCE ISSUES
INTEGRATION ISSUES
PLATFORM-SPECIFIC ISSUES
FILE SYSTEM ISSUES
MIGRATION ISSUES
GETTING HELP
Check Logs
# Enable verbose logging
capysquash squash migrations/*.sql --verbose
# Save output to file
capysquash squash migrations/*.sql --verbose > debug.log 2>&1
# Check Docker logs
docker logs <container-id>Report Issues
When reporting issues, include:
- capysquash version:
capysquash --version - Operating system and version
- Docker version:
docker --version - Error message and full output
- Configuration file (redact sensitive info)
- Sample migration file (if possible)
Where to get help:
NEXT STEPS
How is this guide?