💻 Compatibility

Detailed information about hardware, software, and platform compatibility for YoxOS.

Virtualization

Virtual Machine Support

YoxOS has been tested on all major virtualization platforms.

📦

Oracle VirtualBox

v6.1+ / v7.0+

Fully Supported
💻

VMware Workstation

v16+ / Player 16+

Fully Supported

Microsoft Hyper-V

Windows 10/11 Pro+

Fully Supported
🐧

QEMU / KVM

v6.0+ with KVM

Fully Supported
🏠

Proxmox VE

v7.0+ (KVM-based)

Fully Supported

VMware ESXi

v7.0+ / vSphere

Fully Supported

VM Feature Compatibility Matrix

Feature VirtualBox VMware Hyper-V QEMU/KVM
BIOS Boot Gen 1 only
UEFI Boot Gen 2 ✔ (OVMF)
Display Scaling ✔ (Guest Additions) ✔ (VMware Tools) ✔ (Enhanced Session) ✔ (SPICE)
Audio Output (TTS) Enhanced Session
Microphone (STT) ✔ (USB passthrough) Enhanced Session ✔ (PulseAudio)
Shared Folders ✔ (Guest Additions) ✔ (VMware Tools) ✔ (Enhanced Session) ✔ (9p/virtiofs)
USB Passthrough ✔ (Extension Pack)
3D Acceleration Partial (VMSVGA) ✔ (VirtIO-GPU)
Clipboard Sharing ✔ (Guest Additions) ✔ (VMware Tools) ✔ (Enhanced Session) ✔ (SPICE)
Hardware

Hardware Compatibility

YoxOS is compatible with most x86_64 hardware from 2010 onwards. Based on Ubuntu 22.04 with HWE 6.8 kernel for maximum hardware support.

⚙ Processors (CPU)

BrandSupported ModelsNotes
Intel Core i3/i5/i7/i9 (2nd Gen+), Pentium, Celeron, Xeon SSE4.2 recommended for AI performance
AMD Ryzen 3/5/7/9, Athlon, EPYC, A-series APU Full support including integrated graphics
💡 CPU Requirements for AI

The AI models run on CPU only (no GPU needed). For best AI performance, use a quad-core processor with SSE4.2 or AVX2 instruction set support. The NLLB-200 translation model benefits from more CPU cores and faster RAM.

💾 Memory (RAM)

AmountExperience
2 GB⚠ Desktop only, AI features will not work
4 GB🔶 Minimum for AI features, may be slow on first model load
8 GB✔ Recommended. Smooth AI performance, comfortable multitasking
16 GB+⭐ Excellent. Fast AI inference, heavy multitasking, future-proof

💿 Storage

TypeSupportPerformance
SATA SSD✔ Fully supported⭐ Recommended — Fast AI model loading
NVMe SSD✔ Fully supported⭐ Best — Fastest boot and model loading
SATA HDD✔ Fully supported🔶 Adequate — Slower AI model loading
eMMC✔ Supported🔶 Adequate for basic use
USB External✔ Supported (USB 3.0+)⚠ Not recommended for installation

🌐 Graphics (GPU)

BrandSupportDriver
Intel HD/UHD/Iris ✔ Fully supported (out-of-box) i915 (built-in kernel driver)
AMD Radeon ✔ Fully supported (out-of-box) amdgpu / radeon (built-in kernel driver)
NVIDIA GeForce ✔ Supported (driver install required) nouveau (basic) / nvidia (proprietary, recommended)
💡 NVIDIA GPU Notes

YoxOS boots with the open-source nouveau driver. For best NVIDIA performance, install proprietary drivers after installation: sudo ubuntu-drivers autoinstall. The AI models do NOT use GPU — they run on CPU via PyTorch CPU.

Networking

Network Compatibility

YoxOS supports a wide range of networking hardware and protocols.

📡 Wi-Fi

ChipsetSupportNotes
Intel Wi-Fi 6/6E/7 (AX200/AX210/BE200)✔ FullBest support, recommended
Intel Wireless-AC (8265/9260/9560)✔ FullExcellent support
Qualcomm Atheros (ath9k/ath10k/ath11k)✔ FullGood open-source drivers
Realtek (RTL8821CE/RTL8822BE/RTL8852)✔ PartialMay need firmware package install
Broadcom (BCM4313/BCM43142)⚠ VariesMay need broadcom-sta-dkms
MediaTek (MT7921/MT7922)✔ FullSupported in HWE 6.8 kernel

🔌 Ethernet

Most Ethernet controllers are supported out-of-box including Intel, Realtek (RTL8111/8168), Broadcom, and Aquantia adapters. Gigabit (1GbE) and 2.5GbE controllers are fully supported.

📶 Bluetooth

VersionSupport
Bluetooth 4.0 (BLE)✔ Fully supported
Bluetooth 4.2✔ Fully supported
Bluetooth 5.0 / 5.1 / 5.2✔ Fully supported
Bluetooth 5.3 / 5.4✔ Supported (HWE 6.8 kernel)

🔐 Network Security Protocols

ProtocolSupport
WPA2-Personal (PSK)✔ Fully supported
WPA2-Enterprise (802.1X)✔ Fully supported
WPA3-Personal (SAE)✔ Supported
WPA3-Enterprise✔ Supported
VPN (OpenVPN, WireGuard, IPsec)✔ Supported (install client)
DNS-over-TLS✔ Pre-configured (Quad9 + Cloudflare)
Peripherals

Peripheral Compatibility

Support for external devices and peripherals.

DeviceSupportNotes
USB Keyboards✔ FullHID class, works out-of-box
USB Mice / Trackpads✔ FullHID class, works out-of-box
USB Storage (Flash Drives)✔ FullFAT32, exFAT, NTFS, ext4
USB Audio Devices✔ FullPulseAudio / PipeWire support
USB Webcams✔ FullUVC class cameras
USB Microphones✔ FullImportant for STT feature
Printers (USB)✔ FullCUPS printing system
Printers (Network/Wi-Fi)✔ FullIPP, AirPrint, LPD support
Scanners✔ PartialSANE backend, most major brands
External Displays (HDMI/DP)✔ FullMulti-monitor supported
USB-C / Thunderbolt Docks✔ FullHWE 6.8 kernel for best support
SD Card Readers✔ FullBuilt-in and USB readers
Game Controllers✔ PartialXbox, PlayStation, generic HID
Drawing Tablets (Wacom)✔ FullBuilt-in kernel driver
File Formats

File Format Compatibility

YoxOS supports a wide range of file formats through AfrikGPT-Office and built-in applications.

📄 Document Formats

FormatExtensionApplicationSupport
Microsoft Word.docx, .docAfrikGPT-Office Writer✔ Full
Microsoft Excel.xlsx, .xlsAfrikGPT-Office Calc✔ Full
Microsoft PowerPoint.pptx, .pptAfrikGPT-Office Impress✔ Full
OpenDocument Text.odtAfrikGPT-Office Writer✔ Native
OpenDocument Spreadsheet.odsAfrikGPT-Office Calc✔ Native
OpenDocument Presentation.odpAfrikGPT-Office Impress✔ Native
PDF.pdfEvince / AfrikGPT-Office✔ Full (view & export)
Plain Text.txt, .md, .csvText Editor / Terminal✔ Full
Rich Text.rtfAfrikGPT-Office Writer✔ Full

🎨 Image Formats

FormatExtensionSupport
JPEG.jpg, .jpeg✔ View & edit
PNG.png✔ View & edit
GIF.gif✔ View (animated supported)
WebP.webp✔ View
SVG.svg✔ View & edit (in Draw)
BMP.bmp✔ View
TIFF.tiff, .tif✔ View
RAW.cr2, .nef, .arw⚠ Requires additional software

🎥 Audio & Video Formats

FormatExtensionSupport
MP3.mp3✔ Playback
WAV.wav✔ Playback & recording
OGG Vorbis.ogg✔ Playback
FLAC.flac✔ Playback
MP4 / H.264.mp4✔ Playback
WebM / VP9.webm✔ Playback
MKV.mkv✔ Playback
AVI.avi✔ Playback
💡 Codec Support

YoxOS includes the ubuntu-restricted-extras package for broad multimedia codec support. Most audio and video formats work out-of-box.

💾 Filesystem Support

FilesystemReadWriteNotes
ext4Default filesystem, best performance
ext3 / ext2Legacy Linux filesystems
XFSHigh-performance journaling
BtrfsCopy-on-write, snapshots
NTFSWindows drives, full read/write via ntfs-3g
FAT32 / VFATUSB drives, SD cards
exFATLarge USB drives, SDXC cards
HFS+ (macOS)Read-only recommended
APFS (macOS)Not supported natively
Laptops

Laptop Brand Compatibility

YoxOS works well on most laptop brands. Here is a compatibility overview based on typical hardware configurations.

BrandCompatibilityCommon Notes
Lenovo ThinkPad Excellent Best Linux laptop support. All hardware typically works out-of-box.
Dell XPS / Latitude / Inspiron Excellent Dell ships Ubuntu on many models. Great hardware support.
HP EliteBook / ProBook Excellent Business laptops with good Linux compatibility.
HP Pavilion / Envy Good Most hardware works. Some Realtek Wi-Fi may need firmware.
ASUS VivoBook / ZenBook Good Generally good support. Check Wi-Fi chipset.
Acer Aspire / Swift Good Good support. Optimus GPU switching may need configuration.
System76 Excellent Designed for Linux. Perfect compatibility.
Framework Excellent Designed for Linux. All hardware supported.
Apple MacBook (Intel) Partial Requires rEFInd bootloader. Wi-Fi/BT may not work (use USB adapter).
Apple MacBook (M1/M2/M3) Not Supported ARM architecture. YoxOS is x86_64 only. Use a VM instead.
Microsoft Surface Partial May need linux-surface kernel for touchscreen/Wi-Fi support.
Chromebooks Partial Requires developer mode. Limited hardware support.
💡 Laptop Tips

Before installing YoxOS on a laptop, try the Live USB session first. This lets you test Wi-Fi, display, touchpad, and other hardware without installing. If everything works in the live session, it will work when installed.

Software

Software Ecosystem

YoxOS has access to the entire Ubuntu 22.04 software ecosystem plus Snap Store.

Package Management

SourceTypeCount
Ubuntu APT Repository.deb packages60,000+ packages
Snap StoreSnap packages7,000+ apps
Flatpak (optional)Flatpak bundles2,000+ apps (installable)
AppImagePortable appsWorks out-of-box

Popular Software Available

CategoryApplications
Web BrowsersFirefox (pre-installed), Chromium, Google Chrome, Brave, Vivaldi
CommunicationThunderbird, Slack, Discord, Zoom, Microsoft Teams, Telegram
DevelopmentVS Code, Vim, Git, Python, Node.js, Docker, GCC
MediaVLC, GIMP, Inkscape, Audacity, OBS Studio, Kdenlive
OfficeAfrikGPT-Office (pre-installed), OnlyOffice, Google Docs (web)
EducationAnki, GCompris, Stellarium, GeoGebra
System ToolsGParted, Timeshift, BleachBit, htop, Synaptic

Installing Additional Software

Terminal
# Search for packages
apt search package-name

# Install from APT
sudo apt install package-name

# Install from Snap Store
sudo snap install app-name

# Install Flatpak support (optional)
sudo apt install flatpak gnome-software-plugin-flatpak
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
Limitations

Known Limitations

Current known limitations and workarounds.

LimitationDetailsWorkaround
ARM Architecture YoxOS is x86_64 only. Does not run on ARM CPUs (Apple M-series, Raspberry Pi) Use a virtual machine on ARM hosts, or wait for future ARM release
32-bit Systems No 32-bit (i386) support Requires a 64-bit CPU (most computers from 2006+)
GPU AI Acceleration AI models run on CPU only; no CUDA/ROCm GPU acceleration Use a fast multi-core CPU. GPU support planned for future releases
Incomplete Yoruba Translations Some third-party applications may not have Yoruba translations English fallback is used. Community translation contributions welcome
Secure Boot May need to be disabled for installation on some UEFI systems Disable Secure Boot in BIOS, or use the standard Ubuntu shim
Some Broadcom Wi-Fi Older Broadcom chips may not work out-of-box Install broadcom-sta-dkms or use a USB Wi-Fi adapter
Wayland Some features optimized for X11; Wayland not fully tested Use X11 session (default) for best compatibility

Ready to Get Started?

Download YoxOS and try it on your hardware or in a virtual machine today.