Troubleshooting

Solution

1. Click "More info" on the Windows Defender dialog
2. Click "Run anyway" to proceed with launching AsterIDE
3. This happens because AsterIDE is not yet signed with a Windows certificate

Solution

1. Click "Cancel" on the Gatekeeper dialog
2. Open System Settings → Privacy & Security
3. Scroll down to the "AsterIDE.app was blocked" section
4. Click "Allow Anyway"
5. Try opening AsterIDE again and click "Open" when prompted

Try These Solutions

• • Check system requirements: Ensure your system meets minimum requirements
• • Re-download: Download a fresh copy from the website
• • Check permissions: Ensure the app has permission to run
• • Run as administrator: On Windows, try right-clicking and "Run as administrator"

Solutions

• • Close large files: Working with very large files can slow down performance
• • Reduce search scope: Configure ignored directories in search settings
• • Check memory usage: Ensure you have sufficient free RAM
• • Disable minimap: If enabled, disable it in settings for better performance
• • Restart AsterIDE: Sometimes a fresh start resolves performance issues

Solutions

• • Limit recent files: Reduce recent_files_limit in settings
• • Close unused tabs: Keep only the files you're actively working on open
• • Check for large directories: Avoid opening directories with thousands of files
• • Update to latest version: Newer versions often include performance improvements

Solutions

• • Check file permissions: Ensure AsterIDE can write to ~/.asteride/ directory
• • Verify settings.json: Check if the file exists and is valid JSON
• • Reset settings: Delete ~/.asteride/settings.json to reset to defaults
• • Manual edit: You can manually edit the settings file if the UI isn't working

Solutions

• • Check theme name: Ensure you're using the exact theme name (case-sensitive)
• • Valid theme family: Use "CherryBlossom" or "Rosé Pine"
• • Valid variant: Use exact variant names like "CherryBlossomDark" or "Rosé Pine Moon"
• • Restart AsterIDE: Some theme changes require a restart

Solutions

• • Check ignored directories: Files in .git, node_modules, etc. are excluded by default
• • Minimum characters: Search requires at least 2 characters by default
• • Re-index: Try closing and reopening the project
• • Check file permissions: Ensure AsterIDE can read the files

Solutions

• • Ignore more directories: Add large subdirectories to search_ignored_dirs (e.g., arch, drivers, fs for kernel source)
• • Search in smaller scope: Open only the specific subdirectory you need instead of the entire project
• • Use external search: For extremely large projects, consider using external tools like ripgrep or ag in the terminal
• • Increase min chars: Raise search_min_chars to 4-5 to reduce search frequency
• • Wait for indexing: Initial indexing of large projects may take time; let it complete before searching

Solutions

• • Check limits: Verify recent_files_limit and recent_projects_limit settings
• • File accessibility: Ensure recent files still exist and are accessible
• • Clear recent: Delete ~/.asteride/ directory to reset recent items