Virtualbox !!hot!! - Truenas Scale

TrueNAS SCALE and VirtualBox: Bridging Legacy Virtualization with Modern Hyperconvergence Subject: Virtualization Strategies on TrueNAS SCALE Document Type: Technical Analysis & Implementation Paper Date: April 14, 2026 Abstract TrueNAS SCALE, based on Linux Debian and OpenZFS, is designed as a hyperconverged infrastructure (HCI) platform. While it natively integrates KVM (Kernel-based Virtual Machine) for virtualization, a niche but persistent user demand exists for running Oracle VM VirtualBox alongside or within SCALE. This paper examines the technical feasibility, performance implications, use cases, and step-by-step methodology for deploying VirtualBox on TrueNAS SCALE, comparing it against native KVM and containerized alternatives. It concludes that while VirtualBox is not officially supported or recommended for production workloads, it serves specific lab, legacy OS, and cross-platform portability needs. 1. Introduction TrueNAS SCALE 24.10+ (Electric Eel and later) has evolved significantly, moving toward Docker-native applications and away from legacy Kubernetes. However, its virtualization story remains KVM-centric. VirtualBox—a Type-2 hypervisor—is frequently requested by users migrating from desktop environments or needing to run OSes that behave poorly under KVM (e.g., certain BSD variants, older Windows versions). Key Question: Can you run VirtualBox on TrueNAS SCALE, and if so, how does it compare to native KVM? 2. Architectural Overview 2.1 TrueNAS SCALE Virtualization Stack

Host OS: Debian 12 (Bookworm) Native Hypervisor: KVM + libvirt Containerization: Docker (or previously Kubernetes) Storage Backend: OpenZFS (datasets, zvols)

2.2 VirtualBox Components

Kernel modules ( vboxdrv , vboxnetadp , vboxpci ) User-space tools ( VBoxManage , VirtualBox GUI) Requires compatibility with host kernel headers truenas scale virtualbox

3. Feasibility Analysis | Aspect | KVM (Native) | VirtualBox on SCALE | |--------|--------------|----------------------| | Official Support | Yes (TrueNAS UI) | No (community only) | | Kernel Module Risk | None (in-tree) | High (DKMS failures on kernel updates) | | Performance | Near-bare metal | ~85–90% of KVM | | Snapshot Integration | ZFS + libvirt | Manual (VM-level only) | | USB Passthrough | Limited (via SPICE) | Excellent (VirtualBox extension pack) | | Legacy OS (e.g., OS/2) | Poor | Good | Conclusion: Feasible for non-critical, low-throughput environments. 4. Step-by-Step Implementation Guide

Warning: This modifies the SCALE host OS and may break system updates. Use at your own risk.

4.1 Prerequisites

TrueNAS SCALE 24.10+ installed (not in a VM itself). SSH root or sudo access. Backup of system configuration.

4.2 Enable Developer Mode & Install Dependencies # Enable apt package management (unsupported by iXsystems) sudo sed -i 's/^# deb-src/deb-src/g' /etc/apt/sources.list.d/debian.sources sudo apt update Install kernel headers and build tools sudo apt install -y linux-headers-$(uname -r) dkms build-essential Download VirtualBox for Debian 12 (Bookworm) wget -O virtualbox.deb https://download.virtualbox.org/virtualbox/7.0.14/virtualbox-7.0_7.0.14-161095_Debian_bookworm_amd64.deb

4.3 Install VirtualBox sudo dpkg -i virtualbox.deb sudo apt --fix-broken install -y It concludes that while VirtualBox is not officially

4.4 Load Kernel Modules sudo modprobe vboxdrv sudo systemctl enable vboxdrv

4.5 Create a Virtual Machine (CLI) VBoxManage createvm --name "TestVM" --ostype "Windows10_64" --register VBoxManage modifyvm "TestVM" --memory 4096 --cpus 2 --nic1 bridged --bridgeadapter1 eth0 VBoxManage createhd --filename /mnt/tank/vm/TestVM.vdi --size 50000 VBoxManage storagectl "TestVM" --name "SATA" --add sata VBoxManage storageattach "TestVM" --storagectl "SATA" --port 0 --device 0 --type hdd --medium /mnt/tank/vm/TestVM.vdi