Troubleshooting¶
Common issues and solutions for Tempo.
Overview¶
This section covers common problems and their solutions. If you don't find your issue here, check the FAQ or Common Issues pages.
Quick Links¶
- Common Issues - Detailed solutions for frequent problems
- FAQ - Frequently asked questions
Getting Help¶
If you can't resolve your issue:
- Check the Common Issues page
- Review the FAQ
- Search existing GitHub Issues
- Ask for help on Discord
- Create a new GitHub issue with details
Reporting Issues¶
When reporting an issue, include:
- Description of the problem
- Steps to reproduce
- Expected behavior
- Actual behavior
- Environment details (OS, Docker version, etc.)
- Error messages or logs
- Screenshots if applicable
Common Problem Areas¶
Installation Issues¶
- Docker not starting
- Port conflicts
- Database connection problems
- Missing dependencies
Import Issues¶
- File format not recognized
- Import fails
- Missing data in imported workouts
- Bulk import problems
Performance Issues¶
- Slow imports
- Slow page loads
- High resource usage
- Database performance
Configuration Issues¶
- Settings not saving
- Authentication problems
- CORS errors
- Environment variable issues