Troubleshooting
Installation Issues
Installer won't run on Windows
- Ensure you have Windows 10 or later
- Right-click the installer and select "Run as administrator"
- Check Windows Defender hasn't blocked the file
Can't open app on macOS
- Right-click the app and select "Open" to bypass Gatekeeper
- Check System Preferences → Security & Privacy if blocked
- Ensure you have macOS 10.15 (Catalina) or later
License Issues
License not activating
- Verify your license key is correct
- Check internet connection
- Ensure your license hasn't expired
- Contact support if the issue persists
License expired
- Renew your subscription through the XcodeSol website
- Purchase a lifetime license if available
Grace period expired
- Connect to the internet
- Navigate to Settings → License
- Click "Validate License"
Printer Issues
Printer not printing
- Check printer is powered on and has paper
- Verify correct port/IP address in settings
- Test with "Test Print" button
- Check printer is ESC/POS compatible
Garbled receipt output
- Ensure printer supports ESC/POS protocol
- Check printer baud rate matches settings
- Try a different USB cable
Data Issues
Lost data
- Check database file exists in correct location
- Restore from backup if available
- Contact support for data recovery assistance
App won't start
- Delete database file to reset to factory settings
- Reinstall the application
- Check system requirements are met
Sync Issues
Cloud sync not working
- Verify Supabase URL and anon key are correct
- Check internet connection
- Ensure Supabase project is active
- Re-authenticate if credentials changed
Performance Issues
App running slowly
- Close other applications
- Check available RAM (minimum 4GB recommended)
- Restart the application
- Check for updates
Getting Help
If you continue to experience issues: 1. Check this documentation 2. Review FAQ section 3. Contact XcodeSol support through the purchase website