Troubleshooting
Common issues, errors, and debug locations. Key files: main.js (Electron main process), preload.js (context bridge), src/lib/Security.ts (command validation), src/core/shell-executor.js (shell execution).
First Steps
Quick Tips
Restart First
Most issues are resolved by restarting the app.
Check Logs
View logs via Help > Show Logs or check ~/.config/aartiq-browser/logs/.
Safe Mode
Hold Shift while launching to start in safe mode with extensions disabled.
Report Bugs
Report persistent issues on GitHub with logs from ~/.config/aartiq-browser/logs/.
Browse by Topic
FAQ Categories
Reference
Common Error Codes
E_API_KEYInvalid or missing API key
Check Settings > AI Providers
E_RATE_LIMITAPI rate limit exceeded
Wait and retry, or upgrade plan
E_NETWORKNetwork connectivity issue
Check internet connection
E_PERMISSIONPermission denied
Grant required permissions
E_SYNC_FAILSync operation failed
Reconnect mobile device
E_PDF_GENPDF generation failed
Check template and content
Reference
Debug Locations
App Logs
~/.config/aartiq-browser/logs/Application logs, error traces, and debug output
Configuration
~/.config/aartiq-browser/config.jsonUser settings, preferences, and API key references
Main Process
aartiq-browser/main.jsElectron main process: IPC handler registration, crash reporting via crashReporter
Context Bridge
aartiq-browser/preload.jsPreload script: contextBridge.exposeInMainWorld for secure IPC exposure
Command Execution
src/core/shell-executor.jsShell command execution with risk level validation
Security Validator
src/lib/Security.tsCommand validation, shell sanitization, XSS prevention, URL validation