Installation Issues

Having trouble installing or launching FabriXWork? This guide covers common installation problems and solutions.

Quick Fixes: Try These First

Fix 1: Restart Your Computer

Many installation issues are resolved by a fresh start.

Fix 2: Check System Requirements

macOS:

  • macOS 12.0 (Monterey) or later
  • 8GB RAM minimum (16GB recommended)
  • 2GB free disk space
  • Administrator access for installation

Windows:

  • Windows 10 or later
  • 8GB RAM minimum (16GB recommended)
  • 2GB free disk space
  • Administrator access for installation
  • Python 3.8+ (may be installed automatically)

Fix 3: Run as Administrator

  • macOS: Enter admin password when prompted
  • Windows: Right-click installer → "Run as Administrator"

macOS Issues

Issue: "Apple cannot check it for malicious software"

What's happening:
macOS Gatekeeper is blocking the app because it's from an unidentified developer. This is expected for pilot software.

Solution:

Method 1: System Settings

  1. Try to open FabriXWork
  2. When you see the warning, click Cancel
  3. Go to System Settings → Privacy & Security
  4. Scroll down to find the message about FabriXWork
  5. Click Open Anyway
  6. Confirm by clicking Open

[SCREENSHOT: macOS Privacy & Security settings showing "Open Anyway" button]

Method 2: Right-Click Open

  1. Right-click (or Control-click) on FabriXWork.app
  2. Select Open from the context menu
  3. Click Open in the warning dialog

Issue: App Crashes on Launch

Possible causes:

  • App not moved to Applications folder
  • Corrupted download
  • Incompatible macOS version
  • Missing dependencies

Solutions:

Solution 1: Move to Applications

1. Make sure FabriXWork.app is in your Applications folder
2. If it's in Downloads, drag it to Applications
3. Try launching from Applications

Solution 2: Re-download

1. Delete the current ZIP file
2. Download a fresh copy
3. Unzip and reinstall

Solution 3: Check macOS Version

1. Click Apple menu → About This Mac
2. Check your macOS version
3. If older than 12.0, you'll need to upgrade macOS first

Solution 4: Check Console for Errors

1. Open Console app (in Applications → Utilities)
2. Try to launch FabriXWork
3. Look for error messages related to FabriXWork
4. Share errors with your administrator

Issue: Folder Access Denied

What's happening:
macOS requires explicit permission for apps to access certain folders.

Solution:

  1. Go to System Settings → Privacy & Security
  2. Select Files and Folders
  3. Find FabriXWork in the list
  4. Enable access for the folders you want to use
  5. Restart FabriXWork

[SCREENSHOT: macOS Files and Folders privacy settings showing app permissions]

Issue: App Opens but Shows Blank Screen

Possible causes:

  • Graphics rendering issue
  • Network connectivity problem
  • Corrupted cache

Solutions:

Solution 1: Check Internet Connection

- Verify you have internet access
- Try loading a website in your browser
- If on WiFi, try switching networks

Solution 2: Clear Cache

1. Close FabriXWork
2. Go to ~/Library/Application Support/ (in Finder, press Cmd+Shift+G)
3. Look for a FabriXWork folder
4. Move it to Trash (backup first if needed)
5. Restart FabriXWork

Solution 3: Reinstall

1. Delete FabriXWork from Applications
2. Download fresh copy
3. Reinstall following installation guide

Windows Issues

Issue: Installer Won't Run

Possible causes:

  • Missing administrator privileges
  • Windows Defender blocking
  • Corrupted download

Solutions:

Solution 1: Run as Administrator

1. Right-click on the installer file
2. Select "Run as Administrator"
3. Confirm the UAC prompt

Solution 2: Check Windows Defender

1. Open Windows Security
2. Go to Virus & threat protection
3. Check for blocked threats
4. If FabriXWork is blocked, add an exception

Solution 3: Temporarily Disable Antivirus

⚠️ Only do this if you trust the source
1. Temporarily disable your antivirus
2. Run the installer
3. Re-enable antivirus immediately after

Issue: Python Installation Fails

What's happening:
FabriXWork requires Python for some agent functionalities.

Solutions:

Solution 1: Install Python Manually

1. Go to python.org
2. Download Python 3.8 or later
3. During installation, CHECK "Add Python to PATH"
4. Complete installation
5. Restart your computer
6. Retry FabriXWork installation

Solution 2: Use Windows Store

1. Open Microsoft Store
2. Search for "Python 3.11" (or latest)
3. Click Install
4. Retry FabriXWork installation

Solution 3: Check Python Installation

1. Open Command Prompt
2. Type: python --version
3. If it shows a version, Python is installed
4. If not, follow Solution 1

Issue: "Missing DLL" or "Missing Dependency" Error

What's happening:
Required system libraries are missing.

Solutions:

Solution 1: Install Visual C++ Redistributable

1. Download from Microsoft: "Visual C++ Redistributable for Visual Studio 2015-2022"
2. Install both x86 and x64 versions
3. Restart your computer
4. Retry FabriXWork

Solution 2: Re-run Installer

1. Run the FabriXWork installer again
2. Choose "Repair" if available
3. Or uninstall, then reinstall

Issue: App Won't Start After Installation

Possible causes:

  • Windows Defender quarantine
  • Missing environment variables
  • Corrupted installation

Solutions:

Solution 1: Check Windows Defender

1. Open Windows Security
2. Go to Virus & threat protection → Protection history
3. Look for recently blocked items
4. If FabriXWork files are blocked, restore and add exception

Solution 2: Add to Antivirus Exclusions

1. Open Windows Security
2. Go to Virus & threat protection → Manage settings
3. Scroll to Exclusions → Add or remove exclusions
4. Add the FabriXWork installation folder

Solution 3: Check Event Viewer

1. Press Win+X → Event Viewer
2. Go to Windows Logs → Application
3. Look for errors at the time you tried to launch
4. Share details with administrator

Common Issues (Both Platforms)

Issue: Download Keeps Failing

Solutions:

  • Try a different browser
  • Use a wired connection instead of WiFi
  • Pause other downloads
  • Try from a different network if possible

Issue: ZIP File Won't Extract

macOS:

1. Try double-clicking the ZIP file
2. If that fails, use Terminal: unzip filename.zip
3. If still failing, redownload the file

Windows:

1. Right-click ZIP → Extract All
2. If built-in extractor fails, try 7-Zip (free)
3. Ensure you have write permission to destination folder

Issue: Login Fails After Installation

Possible causes:

  • Network connectivity
  • Incorrect credentials
  • Server not reachable

Solutions:

  1. Check your internet connection
  2. Verify credentials with your administrator
  3. Try on a different network (if possible)
  4. See Login Issues for more help

Still Having Issues?

If none of the above solutions work:

Step 1: Document the Issue

  • What error message do you see? (exact text)
  • At what step does it fail?
  • What have you tried already?
  • Your operating system and version

Step 2: Gather Screenshots

  • Error messages
  • Any relevant settings pages
  • Installation progress (if it gets that far)

Step 3: Contact Support

Reach out to fabriXWork Support Team with the information above.

Prevention Tips

For Future Installations:

  • ✅ Keep your OS updated
  • ✅ Maintain at least 5GB free disk space
  • ✅ Use a stable internet connection
  • ✅ Close other applications during installation
  • ✅ Don't interrupt the installation process

Related: