---
icon: lucide/life-buoy
---

# Troubleshooting

This guide covers common issues and their solutions when using Adaptive Lighting.

## Enable Debug Logging

<!-- CODE:START -->
<!-- import sys; sys.path.insert(0, 'custom_components/adaptive_lighting') -->
<!-- from docs_gen import get_troubleshooting_intro -->
<!-- print(get_troubleshooting_intro()) -->
<!-- CODE:END -->
<!-- OUTPUT:START -->
<!-- OUTPUT:END -->

## Common Problems & Solutions

<!-- CODE:START -->
<!-- import sys; sys.path.insert(0, 'custom_components/adaptive_lighting') -->
<!-- from docs_gen import get_common_problems -->
<!-- print(get_common_problems()) -->
<!-- CODE:END -->
<!-- OUTPUT:START -->
<!-- OUTPUT:END -->

## Getting Help

If you're still having issues:

1. Enable debug logging and capture the relevant logs
2. Open an issue on [GitHub](https://github.com/basnijholt/adaptive-lighting/issues)
3. Include:
   - Your configuration (redact sensitive info)
   - Debug logs
   - Home Assistant version
   - Description of expected vs actual behavior