# Troubleshooting

This guide helps you resolve common issues and problems you might encounter while using HiveFB.

{% hint style="info" %}
**Screenshot placeholder:** Error states collage (optional):

* Red status light (🔴)
* Browser tab showing a connection error
* Dashboard “Connection refused” in the browser
  {% endhint %}

## Common Issues

### "Browser connection failed"

Symptoms:

* Red status light (🔴) in top right
* Cannot start scraping
* Error messages in console
* Browser tab shows errors

Solutions:

{% stepper %}
{% step %}

### Verify Chrome Installation

* Ensure Chrome or Chromium is installed
* Check version is up to date
* Try reinstalling Chrome
  {% endstep %}

{% step %}

### Restart Application

* Close HiveFB completely
* Wait a few seconds
* Restart the application
* Check if connection restores
  {% endstep %}

{% step %}

### Check Windows Firewall

* Windows Firewall may be blocking
* Add HiveFB to allowed applications
* Check antivirus settings
  {% endstep %}

{% step %}

### Run as Administrator

* Right-click HiveFB
* Select "Run as Administrator"
* May resolve permission issues
  {% endstep %}

{% step %}

### Check Port Availability

* Ensure port 9222 is available
* Close other applications using it
* Restart computer if needed
  {% endstep %}
  {% endstepper %}

***

### "Login failed" or Facebook Security Prompt

Symptoms:

* Cannot log in to Facebook
* Facebook asks for security key
* 2FA prompts appear
* Login redirects or fails

Solutions:

{% stepper %}
{% step %}

### Verify Credentials

* Check email and password in Account Manager
* Ensure no typos
* Try logging in via regular browser first
  {% endstep %}

{% step %}

### Facebook Security Key Prompt

This is Facebook's security feature. Options:

* Use your security key if available
* Temporarily disable 2FA in Facebook settings
* Use SMS or authenticator app instead
* Log in via regular browser first (Facebook may remember device)
  {% endstep %}

{% step %}

### Wait Between Sessions

* Wait 30+ minutes between intensive sessions
* Facebook may rate limit rapid logins
* Space out your scraping sessions
  {% endstep %}

{% step %}

### Clear Browser Data

* Facebook may have cached problematic data
* Clear cookies and cache
* Try logging in again
  {% endstep %}
  {% endstepper %}

***

### "No listings found"

Symptoms:

* Scrape completes but finds nothing
* Zero results in dashboard
* Console shows "0 listings discovered"

Solutions:

{% stepper %}
{% step %}

### Verify Search Term

* Check if search term matches available listings
* Try a more common search term
* Test search in regular Facebook Marketplace
  {% endstep %}

{% step %}

### Check Location Settings

* Facebook uses your location for results
* Verify location is correct
* Try changing location in Facebook
  {% endstep %}

{% step %}

### Disable Filters Temporarily

* Temporarily disable blacklist filtering
* Check if relevance threshold too high
* Try with minimal filtering
  {% endstep %}

{% step %}

### Try Different Search Term

* Use a more generic term
* Try variations of your search
* Test with known common terms
  {% endstep %}
  {% endstepper %}

***

### Dashboard Not Loading

Symptoms:

* Dashboard page won't open
* "Connection refused" error
* Blank page or timeout
* Port 3000 unavailable

Solutions:

{% stepper %}
{% step %}

### Ensure Main App Running

* Dashboard requires main app to be running
* Check if HiveFB is open
* Restart main application
  {% endstep %}

{% step %}

### Check Port Availability

* Port 3000 may be in use
* Close other applications using port 3000
* Restart computer if needed
  {% endstep %}

{% step %}

### Try Refreshing

* Refresh the browser page
* Clear browser cache
* Try different browser
  {% endstep %}

{% step %}

### Restart Application

* Close HiveFB completely
* Restart the application
* Try accessing dashboard again
  {% endstep %}

{% step %}

### Check Firewall

* Windows Firewall may block localhost
* Add exception for HiveFB
* Check antivirus settings
  {% endstep %}
  {% endstepper %}

***

### Slow Performance

Symptoms:

* Scraping is very slow
* Dashboard is laggy
* High CPU or memory usage
* Application freezes

Solutions:

{% stepper %}
{% step %}

### Reduce Max Listings

* Lower the maximum listings count
* Start with smaller batches
* Process in multiple sessions
  {% endstep %}

{% step %}

### Increase Scroll Speed

* Add more delay between scrolls
* Slower is safer but takes longer
* Find balance for your system
  {% endstep %}

{% step %}

### Close Other Applications

* Free up system resources
* Close unnecessary programs
* Check task manager for resource hogs
  {% endstep %}

{% step %}

### Check Disk Space

* Ensure sufficient free space
* Database needs space to grow
* Clear old data if needed
  {% endstep %}

{% step %}

### Clear Old Data

* Remove old listings if database large
* Archive old data
* Keep database size manageable
  {% endstep %}

{% step %}

### System Resources

* Check available RAM
* Monitor CPU usage
* Consider system upgrade if consistently slow
  {% endstep %}
  {% endstepper %}

***

## Advanced Troubleshooting

### Clear Application Data

When to Use:

* Persistent errors
* Corrupted database
* Settings issues
* Complete reset needed

Steps:

{% stepper %}
{% step %}

### Close HiveFB

* Ensure application is completely closed
* Check task manager for processes
  {% endstep %}

{% step %}

### Backup Important Data

* Copy `scraped_data` folder
* Export any important listings
* Save catalogue configurations
  {% endstep %}

{% step %}

### Navigate to Data Folder

* Go to: `C:\Users\<YourUsername>\AppData\Roaming\HiveFB\`
* This is your data directory
  {% endstep %}

{% step %}

### Delete Files (Optional)

* Delete database files (will lose data)
* Delete settings files (will reset settings)
* Keep `scraped_data` folder if needed
  {% endstep %}

{% step %}

### Restart Application

* Launch HiveFB
* Fresh start with clean data
* Reconfigure settings
  {% endstep %}
  {% endstepper %}

***

### Reset Settings

Steps:

{% stepper %}
{% step %}

### Open Settings

* Main app or dashboard settings
* Find reset option
  {% endstep %}

{% step %}

### Reset to Defaults

* Click "Reset to Defaults"
* Confirm action
* Settings restored
  {% endstep %}

{% step %}

### Manual Reset

* Delete settings files
* Restart application
* Defaults will be applied
  {% endstep %}
  {% endstepper %}

***

### Check Logs

Console Tab:

* Open Console tab in main app
* Look for error messages
* Note error codes
* Check timestamps

Error Messages:

* Copy error messages
* Note when errors occur
* Check for patterns
* Use for support requests

Debug Mode:

* Run with `npm run dev` (if from source)
* More verbose logging
* Detailed error information
* Helpful for diagnosis

***

### Database Issues

Symptoms:

* Database errors
* Corrupted data
* Missing listings
* Performance issues

Solutions:

{% stepper %}
{% step %}

### Database Repair

* Close HiveFB
* Use SQLite tools to repair
* Or delete and recreate database
  {% endstep %}

{% step %}

### Backup and Restore

* Backup database file
* Restore from backup
* Or start fresh
  {% endstep %}

{% step %}

### Migration Issues

* Database may need migration
* Check for update notifications
* Update to latest version
  {% endstep %}
  {% endstepper %}

***

## Getting Help

### Before Seeking Help

{% stepper %}
{% step %}

### Check This Guide

Review troubleshooting steps
{% endstep %}

{% step %}

### Check Console

Look for error messages
{% endstep %}

{% step %}

### Try Restarting

Often fixes temporary issues
{% endstep %}

{% step %}

### Check Logs

Review application logs
{% endstep %}
{% endstepper %}

***

### When Contacting Support

{% stepper %}
{% step %}

### Include Error Messages

* Error messages (exact text)
* When error occurs
* Steps to reproduce
  {% endstep %}

{% step %}

### System Information

* Operating system version
* HiveFB version
* Available RAM
* Disk space
* Error logs
  {% endstep %}
  {% endstepper %}

***

### Support Resources

* GitHub Issues: Report bugs
* Documentation: Review guides
* Community: Ask questions
* Changelog: Check known issues

***

<details>

<summary>Still having issues? Check the FAQ</summary>

See the FAQ for more answers: [FAQ](/help/faq.md)

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.hivefb.app/help/troubleshooting.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.