Troubleshooting

Common Issues

Browser Won’t Launch

Symptom	Solution
Browser doesn’t open	Ensure Microsoft Edge, Brave, or Chrome is installed
“Failed to start” error	Check that the browser path in Preferences is correct
Browser crashes on launch	Try a different browser or update your browser

AI Engine Won’t Start

Symptom	Solution
“Failed to start” error	Lower GPU Layers to 0 (CPU-only)
Out of memory error	Reduce Context Size or close other applications
Download fails	Check internet connection and disk space
Engine crashes	Try a smaller model or reduce GPU Layers

Project Fails to Run

Symptom	Solution
Element not found	Check your selectors. Use the element picker to verify.
Timeout errors	Increase Navigation Timeout in project settings
CAPTCHA blocks	Configure CAPTCHA solving in Stealth settings
Proxy errors	Test your proxies. Check proxy format.
Page won’t load	Check the URL. Ensure the site is accessible.

Data Not Extracted

Symptom	Solution
Empty results	Check your selectors and item selector
Wrong data	Verify the property type and selector
Missing records	Check if pagination is configured correctly
Data truncated	Check if the page uses lazy loading or infinite scroll

Triggers Not Running

Symptom	Solution
Triggers don’t fire	Ensure the project completed successfully
API errors	Check API keys and endpoints
Database errors	Verify database credentials and connectivity
Email not sent	Check SMTP settings and credentials

Log Files

Logs are stored in:

~/.rtila-x/logs/

Check logs for detailed error messages.

Getting Help

1. Check the Execution Logs page for error details.
2. Check the Support Forum at rtila.net.
3. Contact support at support@rtila.com.

Resetting the Application

If RTILA X is in a broken state:

1. Close RTILA X completely.
2. Delete the RTILA data directory:

   ~/.rtila-x/

3. Restart RTILA X. It will re-initialize.

⚠️ Warning: This deletes all projects, data, and settings. Back up your data first.