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 |
Recommended Requirements¶
| 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 |
Recommended Camera Specifications¶
| 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:
- Press
Win + R - Type
msinfo32 - Press Enter
- Review System Summary
Camera Check¶
To verify camera functionality:
- Open Windows Camera app
- Verify camera works
- Check video quality
- Note camera model
Performance Verification¶
After installing GuacamoleID:
- Check Task Manager for resource usage
- Verify CPU usage is reasonable (2-10%)
- Check memory usage (~200-400 MB)
- Ensure smooth face recognition