Troubleshooting Guide

Solutions for common F3L1X issues and errors

troubleshooting errors help support Updated: Feb. 4, 2026

Troubleshooting Guide

This guide covers common issues and their solutions when working with F3L1X.

Quick Diagnostics

Before diving into specific issues, run these checks:

f3l1x status
f3l1x check

These commands will verify your installation and show any problems.

Installation Issues

Installer Won't Run

Symptom: Double-clicking installer does nothing or shows error.

Solutions:

  1. Run as Administrator
    - Right-click installer
    - Select "Run as administrator"

  2. Disable Antivirus Temporarily
    - Windows Defender may block unsigned installers
    - Add exception or disable temporarily during install

  3. Check Disk Space
    - Need at least 2GB free space
    - Check your available storage in File Explorer

"Windows Protected Your PC" Warning

Symptom: SmartScreen blocks the installer.

Solution:
1. Click "More info"
2. Click "Run anyway"

This is normal for new software without extensive download history.

Installation Path Issues

Symptom: Install fails with path errors.

Solutions:

  1. Avoid spaces in path
    - Use simple paths without special characters
    - Example: C:\F3L1X\ instead of C:\Program Files\F3L1X Tech\

  2. Don't install in Program Files
    - Protected location requires admin rights for every operation
    - Use Desktop or Documents folder instead

Service Startup Issues

Dashboard Won't Start

Symptom: F3L1X doesn't open after installation.

Solutions:

  1. Check if already running
    - Look in system tray for F3L1X icon
    - Try opening browser to localhost:8000

  2. Restart F3L1X
    - Close any F3L1X windows
    - Open Start Menu and launch F3L1X again

  3. Check Windows Event Viewer
    - Look for errors in Application logs

Services Not Connecting

Symptom: Dashboard opens but shows services offline.

Solutions:

  1. Wait a moment
    - Services take a few seconds to start
    - Refresh the page after 10 seconds

  2. Restart all services
    f3l1x stop --all f3l1x start-all

  3. Check firewall
    - F3L1X needs local network access
    - Allow F3L1X through Windows Firewall if prompted

Authentication Issues

Dashboard Stays Locked

Symptom: Login successful but dashboard doesn't unlock.

Solutions:

  1. Clear browser cache
    - Press Ctrl+Shift+Delete in your browser
    - Clear cookies and cache
    - Try logging in again

  2. Try a different browser
    - Chrome, Firefox, or Edge
    - Make sure browser is up to date

  3. Check your subscription
    - Ensure your subscription is active at f3l1x.tech/account

Activation Code Not Working

Symptom: 6-digit code not accepted.

Solutions:

  1. Code expired
    - Codes expire after 15 minutes
    - Request a new code by restarting F3L1X

  2. Wrong account
    - Ensure you're logged in with correct account at f3l1x.tech

  3. Device limit reached
    - Check how many devices are activated
    - Deactivate unused devices at f3l1x.tech/account

Network Issues

"Connection Refused" Errors

Symptom: Can't connect to services.

Solutions:

  1. Service not running
    f3l1x status
    Start any stopped services.

  2. Firewall blocking
    - Allow F3L1X through Windows Firewall
    - Check third-party security software

Timeout Errors

Symptom: Operations hang then timeout.

Solutions:

  1. Check system resources
    - Open Task Manager
    - Ensure CPU and memory aren't maxed out

  2. Restart services
    f3l1x restart --all

  3. Check logs for errors
    f3l1x logs

Database Issues

Data Not Saving

Symptom: Changes aren't persisted.

Solutions:

  1. Check disk space
    - Ensure you have free space available

  2. Restart F3L1X
    - Temporary files may need to be cleared

  3. Check file permissions
    - F3L1X needs write access to its data folder

"Database Locked" Error

Symptom: Error about database being locked.

Solutions:

  1. Close other F3L1X instances
    - Only one instance should run at a time
    - Check Task Manager for multiple processes

  2. Wait and retry
    - The lock usually clears within seconds

  3. Restart F3L1X
    - This clears any stuck locks

Performance Issues

Slow Startup

Symptom: F3L1X takes long to start.

Solutions:

  1. Check antivirus
    - Real-time scanning can slow startup
    - Add F3L1X folder to exclusions

  2. Close unnecessary applications
    - Free up system resources

  3. Use SSD
    - SSDs significantly improve startup time

High Memory Usage

Symptom: F3L1X using too much RAM.

Solutions:

  1. Restart F3L1X periodically
    - Long-running sessions accumulate memory

  2. Close unused realms
    - Only run realms you're actively using

  3. Check system memory
    - F3L1X recommends 8GB RAM minimum

Common Error Messages

"Module Not Found"

Cause: Missing component.

Solution:
- Reinstall F3L1X to restore missing files
- Or run f3l1x repair

"Configuration Error"

Cause: Invalid settings.

Solution:
1. Check your configuration at f3l1x.tech/account
2. Reset to defaults: f3l1x reset-config

"Service Unavailable"

Cause: Service not running or crashed.

Solution:
1. Check status: f3l1x status
2. Restart: f3l1x restart <service-name>

Getting Help

Before Asking for Help

Gather this information:

  1. Error message - Full text, not paraphrased
  2. Steps to reproduce - What you did before the error
  3. System info - Windows version, RAM, disk space
  4. F3L1X version - Run f3l1x --version

Support Resources

Resource Description
Documentation Full documentation
Email Support hello@f3l1x.tech
Account Issues f3l1x.tech/account

Logging

To get detailed logs for troubleshooting:

f3l1x logs --verbose

Share relevant log entries (without personal information) when contacting support.

Resetting F3L1X

If all else fails, you can reset F3L1X:

f3l1x reset

Warning: This removes all configuration. Your data files are preserved, but you'll need to set up F3L1X again.

Next Steps