Troubleshooting

Solutions to common issues with Laradebug.

Installation Issues

"App is damaged" on macOS

macOS may block unsigned apps. To fix:

1. Right-click the app in Finder
2. Select Open from the menu
3. Click Open in the dialog
4. The app is now trusted

Or via Terminal:

xattr -cr /Applications/Laradebug.app

App Won't Launch

1. Check macOS version (requires 11.0+)
2. Try downloading again (corrupted download)
3. Move app to Applications folder
4. Restart your Mac

Permission Denied

If Laradebug can't access your project:

1. Go to System Preferences → Security & Privacy → Privacy
2. Select Files and Folders
3. Ensure Laradebug has access to your projects folder

Project Issues

"PHP Not Found"

Error: PHP executable not found

Solutions:

1. Install PHP 8.0 or higher
2. Verify PHP is in your PATH:

   which php
   php -v

3. If using Herd/Valet, ensure it's running
4. Set custom PHP path in Settings → General → PHP Path

"Artisan Command Failed"

Error: Failed to execute artisan command

Solutions:

1. Test artisan works manually:

   cd /path/to/project
   php artisan tinker

2. Check .env file exists and is valid
3. Verify database credentials
4. Run composer install if dependencies are missing

Database Issues

Connection Refused

SQLSTATE[HY000] [2002] Connection refused

Solutions:

1. Start your database server (MySQL, PostgreSQL, etc.)
2. Check .env database credentials:

   DB_HOST=127.0.0.1
   DB_PORT=3306
   DB_DATABASE=your_database
   DB_USERNAME=your_user
   DB_PASSWORD=your_password

3. Verify database exists
4. Test connection with database client

HTTP Monitoring Issues

Requests Not Captured

Check:

1. HTTP toggle is enabled (amber)
2. Using Laravel's Http facade (not raw Guzzle)
3. Code actually executed

Correct usage:

// This is captured
Http::get('https://api.example.com');

// This is NOT captured
(new \GuzzleHttp\Client())->get('https://api.example.com');

AI Assistant Issues

"API Key Invalid"

Solutions:

1. Verify key is copied correctly (no extra spaces)
2. Check key hasn't expired
3. Ensure you have API credits
4. Try generating a new key

Ollama Not Connecting

Solutions:

1. Verify Ollama is running:

   ollama list

2. Check URL in settings (default: http://localhost:11434)
3. Ensure a model is downloaded:

   ollama pull llama3.2

4. Restart Ollama

Slow AI Responses

Solutions:

• Claude: Check internet connection
• Ollama: Try a smaller model (phi, mistral)
• Clear chat history (long conversations slow down)

Autocompletion Issues

Suggestions Not Appearing

Solutions:

1. Check autocompletion is enabled in Settings
2. Try Ctrl + Space to manually trigger
3. Refresh autocomplete index: Settings → Editor → Refresh Autocomplete Index
4. Verify project loaded correctly

Missing Classes

Solutions:

1. Refresh autocomplete index
2. Run composer dump-autoload in your project
3. Check class file exists and has correct namespace
4. Restart Laradebug

Getting Help

Check Logs

Laradebug logs are at:

~/Library/Logs/Laradebug/

Report Issues

If problems persist:

1. Note the exact error message
2. Note steps to reproduce
3. Check if it happens with other projects
4. Report at GitHub Issues

Reset Settings

To reset all settings:

1. Quit Laradebug
2. Delete preferences:

   rm -rf ~/Library/Application\ Support/Laradebug/

3. Restart Laradebug

WARNING

This removes all settings, snippets, and history.

Common Error Messages

Error	Meaning	Solution
EACCES	Permission denied	Check file/folder permissions
ENOENT	File not found	Verify path exists
ECONNREFUSED	Connection refused	Start the required service
ETIMEDOUT	Connection timed out	Check network/service status
ENOMEM	Out of memory	Reduce data size, restart app

Still Stuck?

1. Restart Laradebug
2. Restart your Laravel development server
3. Check Laravel logs: storage/logs/laravel.log
4. Try with a fresh Laravel project to isolate the issue