🛠️Troubleshooting

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

Screenshot placeholder: Error states collage (optional):

• Red status light (🔴)

• Browser tab showing a connection error

• Dashboard “Connection refused” in the browser

Common Issues

"Browser connection failed"

Symptoms:

• Red status light (🔴) in top right

• Cannot start scraping

• Error messages in console

• Browser tab shows errors

Solutions:

1

Verify Chrome Installation

• Ensure Chrome or Chromium is installed

• Check version is up to date

• Try reinstalling Chrome

2

Restart Application

• Close HiveFB completely

• Wait a few seconds

• Restart the application

• Check if connection restores

3

Check Windows Firewall

• Windows Firewall may be blocking

• Add HiveFB to allowed applications

• Check antivirus settings

4

Run as Administrator

• Right-click HiveFB

• Select "Run as Administrator"

• May resolve permission issues

5

Check Port Availability

• Ensure port 9222 is available

• Close other applications using it

• Restart computer if needed

---

"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:

1

Verify Credentials

• Check email and password in Account Manager

• Ensure no typos

• Try logging in via regular browser first

2

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)

3

Wait Between Sessions

• Wait 30+ minutes between intensive sessions

• Facebook may rate limit rapid logins

• Space out your scraping sessions

4

Clear Browser Data

• Facebook may have cached problematic data

• Clear cookies and cache

• Try logging in again

---

"No listings found"

Symptoms:

• Scrape completes but finds nothing

• Zero results in dashboard

• Console shows "0 listings discovered"

Solutions:

1

Verify Search Term

• Check if search term matches available listings

• Try a more common search term

• Test search in regular Facebook Marketplace

2

Check Location Settings

• Facebook uses your location for results

• Verify location is correct

• Try changing location in Facebook

3

Disable Filters Temporarily

• Temporarily disable blacklist filtering

• Check if relevance threshold too high

• Try with minimal filtering

4

Try Different Search Term

• Use a more generic term

• Try variations of your search

• Test with known common terms

---

Dashboard Not Loading

Symptoms:

• Dashboard page won't open

• "Connection refused" error

• Blank page or timeout

• Port 3000 unavailable

Solutions:

1

Ensure Main App Running

• Dashboard requires main app to be running

• Check if HiveFB is open

• Restart main application

2

Check Port Availability

• Port 3000 may be in use

• Close other applications using port 3000

• Restart computer if needed

3

Try Refreshing

• Refresh the browser page

• Clear browser cache

• Try different browser

4

Restart Application

• Close HiveFB completely

• Restart the application

• Try accessing dashboard again

5

Check Firewall

• Windows Firewall may block localhost

• Add exception for HiveFB

• Check antivirus settings

---

Slow Performance

Symptoms:

• Scraping is very slow

• Dashboard is laggy

• High CPU or memory usage

• Application freezes

Solutions:

1

Reduce Max Listings

• Lower the maximum listings count

• Start with smaller batches

• Process in multiple sessions

2

Increase Scroll Speed

• Add more delay between scrolls

• Slower is safer but takes longer

• Find balance for your system

3

Close Other Applications

• Free up system resources

• Close unnecessary programs

• Check task manager for resource hogs

4

Check Disk Space

• Ensure sufficient free space

• Database needs space to grow

• Clear old data if needed

5

Clear Old Data

• Remove old listings if database large

• Archive old data

• Keep database size manageable

6

System Resources

• Check available RAM

• Monitor CPU usage

• Consider system upgrade if consistently slow

---

Advanced Troubleshooting

Clear Application Data

When to Use:

• Persistent errors

• Corrupted database

• Settings issues

• Complete reset needed

Steps:

1

Close HiveFB

• Ensure application is completely closed

• Check task manager for processes

2

Backup Important Data

• Copy scraped_data folder

• Export any important listings

• Save catalogue configurations

3

Navigate to Data Folder

• Go to: C:\Users\<YourUsername>\AppData\Roaming\HiveFB\

• This is your data directory

4

Delete Files (Optional)

• Delete database files (will lose data)

• Delete settings files (will reset settings)

• Keep scraped_data folder if needed

5

Restart Application

• Launch HiveFB

• Fresh start with clean data

• Reconfigure settings

---

Reset Settings

Steps:

1

Open Settings

• Main app or dashboard settings

• Find reset option

2

Reset to Defaults

• Click "Reset to Defaults"

• Confirm action

• Settings restored

3

Manual Reset

• Delete settings files

• Restart application

• Defaults will be applied

---

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:

1

Database Repair

• Close HiveFB

• Use SQLite tools to repair

• Or delete and recreate database

2

Backup and Restore

• Backup database file

• Restore from backup

• Or start fresh

3

Migration Issues

• Database may need migration

• Check for update notifications

• Update to latest version

---

Getting Help

Before Seeking Help

1

Check This Guide

Review troubleshooting steps

2

Check Console

Look for error messages

3

Try Restarting

Often fixes temporary issues

4

Check Logs

Review application logs

---

When Contacting Support

1

Include Error Messages

• Error messages (exact text)

• When error occurs

• Steps to reproduce

2

System Information

• Operating system version

• HiveFB version

• Available RAM

• Disk space

• Error logs

---

Support Resources

• GitHub Issues: Report bugs

• Documentation: Review guides

• Community: Ask questions

• Changelog: Check known issues

---

Still having issues? Check the FAQ

See the FAQ for more answers: FAQ