System Requirements

Overview

This page outlines the hardware and software requirements for running GuacamoleID on your computer. Meeting these requirements ensures optimal performance and reliability.

Operating System

Supported Systems

Operating System Version Support Level
Windows 11 (64-bit) Full Support
Windows 10 (64-bit) Full Support
Ubuntu Linux 24.04 LTS Full Support
Ubuntu Linux 22.04 LTS Full Support
IGEL OS 12 Full Support
macOS Coming Soon

Hardware Requirements

Minimum Requirements

Componen Requirement
Processor Minimum Intel Core i5 or AMD equivalent
RAM 8 GB
Storage 1 GB available space
Camera USB 2.0 webcam (720p minimum)
Display 1280 x 720 resolution
Component Requirement
Processor Intel Core i5 (8th gen) or AMD equivalent
RAM 8 GB or more
Storage 1 GB available space (SSD preferred)
Camera USB 3.0 webcam (1080p)
Display 1920 x 1080 resolution

Optimal Performance

Component Recommendation
Processor Intel Core i7 (10th gen+) with integrated GPU
RAM 16 GB
Storage SSD with 2 GB available
Camera IR camera (Windows Hello compatible)

Camera Requirements

Minimum Camera Specifications

Specification Minimum
Resolution 720p (1280 x 720)
Frame Rate 15 fps
Interface USB 2.0
Focus Fixed or auto-focus
Specification Recommended
Resolution 1080p (1920 x 1080)
Frame Rate 30 fps
Interface USB 3.0
Focus Auto-focus
Low Light Low-light capable

IR Camera (For Depth Vision)

For Depth Vision Liveness:

Specification Requirement
Type Windows Hello compatible IR camera
Depth Sensing Required for full Depth Vision
Examples Intel RealSense, Tobii, Built-in Windows Hello cameras

Virtual Cameras

Guacamole may not work with: - OBS Virtual Camera - ManyCam - Other virtual camera software

Physical cameras are required for face recognition.

GPU Requirements

Integrated Graphics (Minimum)

Guacamole runs on integrated graphics:

  • Intel HD Graphics 520 or newer
  • AMD Radeon Graphics (Ryzen APUs)

Dedicated GPU (Optional)

Dedicated GPUs can improve performance:

  • Any modern NVIDIA or AMD GPU
  • Not required for operation
  • May reduce CPU load

Intel OpenVINO Acceleration

GuacamoleID uses Intel OpenVINO for AI acceleration:

  • Automatically uses CPU instructions (AVX, SSE)
  • Intel GPUs can provide acceleration
  • No special configuration needed

Display Requirements

Multi-Monitor

  • Supported on all monitors
  • Block screen covers all displays

Display Scaling

  • Windows display scaling supported
  • 100%, 125%, 150%, 175%, 200% scaling tested
  • High DPI displays supported

Power Requirements

Desktop Systems

No special power requirements beyond normal computer operation.

Laptop Systems

Power Mode Camera Usage AI Processing
Plugged In Normal Full power
Battery Configurable Can be reduced
Power Saver Reduced Minimized

Battery Impact

With default settings on battery:

  • ~5-10% additional battery consumption
  • Varies by camera and settings
  • Use Power Saver mode to minimize

Compatibility Notes

Known Issues

  • Some webcam software may conflict with camera access
  • Virtual cameras are not supported
  • Remote desktop sessions have limited support
  • VMware/VirtualBox may have camera passthrough issues

Anti-Virus Software

Guacamole is compatible with major antivirus software:

  • Windows Defender (fully tested)
  • Norton
  • McAfee
  • Kaspersky
  • Bitdefender

You may need to add exceptions for: - Installation directory - Camera access

Checking Your System

System Information

To view your system specifications:

  1. Press Win + R
  2. Type msinfo32
  3. Press Enter
  4. Review System Summary

Camera Check

To verify camera functionality:

  1. Open Windows Camera app
  2. Verify camera works
  3. Check video quality
  4. Note camera model

Performance Verification

After installing GuacamoleID:

  1. Check Task Manager for resource usage
  2. Verify CPU usage is reasonable (2-10%)
  3. Check memory usage (~200-400 MB)
  4. Ensure smooth face recognition