Detailed information about hardware, software, and platform compatibility for YoxOS.
YoxOS has been tested on all major virtualization platforms.
v6.1+ / v7.0+
Fully Supportedv16+ / Player 16+
Fully SupportedWindows 10/11 Pro+
Fully Supportedv6.0+ with KVM
Fully Supportedv7.0+ (KVM-based)
Fully Supportedv7.0+ / vSphere
Fully Supported| 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) |
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.
| Brand | Supported Models | Notes |
|---|---|---|
| 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 |
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.
| Amount | Experience |
|---|---|
| 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 |
| Type | Support | Performance |
|---|---|---|
| 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 |
| Brand | Support | Driver |
|---|---|---|
| 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) |
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.
YoxOS supports a wide range of networking hardware and protocols.
| Chipset | Support | Notes |
|---|---|---|
| Intel Wi-Fi 6/6E/7 (AX200/AX210/BE200) | ✔ Full | Best support, recommended |
| Intel Wireless-AC (8265/9260/9560) | ✔ Full | Excellent support |
| Qualcomm Atheros (ath9k/ath10k/ath11k) | ✔ Full | Good open-source drivers |
| Realtek (RTL8821CE/RTL8822BE/RTL8852) | ✔ Partial | May need firmware package install |
| Broadcom (BCM4313/BCM43142) | ⚠ Varies | May need broadcom-sta-dkms |
| MediaTek (MT7921/MT7922) | ✔ Full | Supported in HWE 6.8 kernel |
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.
| Version | Support |
|---|---|
| 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) |
| Protocol | Support |
|---|---|
| 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) |
Support for external devices and peripherals.
| Device | Support | Notes |
|---|---|---|
| USB Keyboards | ✔ Full | HID class, works out-of-box |
| USB Mice / Trackpads | ✔ Full | HID class, works out-of-box |
| USB Storage (Flash Drives) | ✔ Full | FAT32, exFAT, NTFS, ext4 |
| USB Audio Devices | ✔ Full | PulseAudio / PipeWire support |
| USB Webcams | ✔ Full | UVC class cameras |
| USB Microphones | ✔ Full | Important for STT feature |
| Printers (USB) | ✔ Full | CUPS printing system |
| Printers (Network/Wi-Fi) | ✔ Full | IPP, AirPrint, LPD support |
| Scanners | ✔ Partial | SANE backend, most major brands |
| External Displays (HDMI/DP) | ✔ Full | Multi-monitor supported |
| USB-C / Thunderbolt Docks | ✔ Full | HWE 6.8 kernel for best support |
| SD Card Readers | ✔ Full | Built-in and USB readers |
| Game Controllers | ✔ Partial | Xbox, PlayStation, generic HID |
| Drawing Tablets (Wacom) | ✔ Full | Built-in kernel driver |
YoxOS supports a wide range of file formats through AfrikGPT-Office and built-in applications.
| Format | Extension | Application | Support |
|---|---|---|---|
| Microsoft Word | .docx, .doc | AfrikGPT-Office Writer | ✔ Full |
| Microsoft Excel | .xlsx, .xls | AfrikGPT-Office Calc | ✔ Full |
| Microsoft PowerPoint | .pptx, .ppt | AfrikGPT-Office Impress | ✔ Full |
| OpenDocument Text | .odt | AfrikGPT-Office Writer | ✔ Native |
| OpenDocument Spreadsheet | .ods | AfrikGPT-Office Calc | ✔ Native |
| OpenDocument Presentation | .odp | AfrikGPT-Office Impress | ✔ Native |
| Evince / AfrikGPT-Office | ✔ Full (view & export) | ||
| Plain Text | .txt, .md, .csv | Text Editor / Terminal | ✔ Full |
| Rich Text | .rtf | AfrikGPT-Office Writer | ✔ Full |
| Format | Extension | Support |
|---|---|---|
| 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 |
| Format | Extension | Support |
|---|---|---|
| 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 |
YoxOS includes the ubuntu-restricted-extras package for broad multimedia codec support. Most audio and video formats work out-of-box.
| Filesystem | Read | Write | Notes |
|---|---|---|---|
| ext4 | ✔ | ✔ | Default filesystem, best performance |
| ext3 / ext2 | ✔ | ✔ | Legacy Linux filesystems |
| XFS | ✔ | ✔ | High-performance journaling |
| Btrfs | ✔ | ✔ | Copy-on-write, snapshots |
| NTFS | ✔ | ✔ | Windows drives, full read/write via ntfs-3g |
| FAT32 / VFAT | ✔ | ✔ | USB drives, SD cards |
| exFAT | ✔ | ✔ | Large USB drives, SDXC cards |
| HFS+ (macOS) | ✔ | ⚠ | Read-only recommended |
| APFS (macOS) | ✘ | ✘ | Not supported natively |
YoxOS works well on most laptop brands. Here is a compatibility overview based on typical hardware configurations.
| Brand | Compatibility | Common 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. |
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.
YoxOS has access to the entire Ubuntu 22.04 software ecosystem plus Snap Store.
| Source | Type | Count |
|---|---|---|
| Ubuntu APT Repository | .deb packages | 60,000+ packages |
| Snap Store | Snap packages | 7,000+ apps |
| Flatpak (optional) | Flatpak bundles | 2,000+ apps (installable) |
| AppImage | Portable apps | Works out-of-box |
| Category | Applications |
|---|---|
| Web Browsers | Firefox (pre-installed), Chromium, Google Chrome, Brave, Vivaldi |
| Communication | Thunderbird, Slack, Discord, Zoom, Microsoft Teams, Telegram |
| Development | VS Code, Vim, Git, Python, Node.js, Docker, GCC |
| Media | VLC, GIMP, Inkscape, Audacity, OBS Studio, Kdenlive |
| Office | AfrikGPT-Office (pre-installed), OnlyOffice, Google Docs (web) |
| Education | Anki, GCompris, Stellarium, GeoGebra |
| System Tools | GParted, Timeshift, BleachBit, htop, Synaptic |
# 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
Current known limitations and workarounds.
| Limitation | Details | Workaround |
|---|---|---|
| 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 |
Download YoxOS and try it on your hardware or in a virtual machine today.