Skip to content
Documentation: Requirements

Documentation · Getting started

Requirements

What your computer needs to run OSX-REIMS, and the macOS versions it offers.

Alpha

This documentation covers OSX-REIMS 0.6.0, alpha software. Commands and options may change between versions; when in doubt, check osx-reims --help on the installed version.

Computer

Item Requirement
System Ubuntu Desktop 26.04 LTS, 64-bit (x86_64)
Processor 64-bit Intel or AMD, with hardware virtualization (Intel VT-x or AMD-V) enabled in the BIOS/UEFI
GPU Vulkan 1.2 or later (Intel, AMD or NVIDIA), with its driver installed; on NVIDIA cards, NVIDIA's full driver (see below)
Nested VMs (optional) An Intel processor, with nested virtualization on in KVM (kvm_intel nested=Y, Ubuntu's default)
Storage At least 14 GB free: 10 GB for Reims vGPU, in /opt, and 4 GB for Rust, in your home folder, plus space for your VMs (tens of GB each)
Internet Needed to prepare the computer, download the recovery from Apple and, for the first VM, the EFI components
Bridged network (optional) A wired network port, managed by NetworkManager (Ubuntu Desktop's default); Wi-Fi will not do

On a system other than Ubuntu 26.04, setup warns that the system was not tested and asks whether to continue. With -y, it stops.

VM memory and processors

Memory and processors are chosen on each VM's first start and saved in that VM, so the next starts do not ask again. The suggested values (8 GB and 4 processors) are not minimum requirements for the computer. See VM settings.

On a computer with more than one GPU, each VM can run on the GPU chosen for it; without a choice, the VM runs on the dedicated GPU.

GPU and driver

Reims vGPU needs the GPU's Vulkan driver to offer the VK_EXT_external_memory_host extension. Intel's and AMD's drivers and NVIDIA's full driver do; the open nouveau driver (NVK) does not. A GPU without it is not listed among the GPUs a VM can use, and osx-reims doctor warns about it.

  • NVIDIA. Install NVIDIA's full driver, for example with sudo ubuntu-drivers install, and restart the computer. It brings the libcuda.so.1 library, which NVIDIA's Vulkan needs for Reims vGPU.
  • AMD. The VM's memory reaches the GPU through /dev/udmabuf, which setup opens to you by adding your user to the kvm group. Ubuntu 26.04's Mesa already has what Reims vGPU needs; with an older Mesa, doctor warns (Large GPU buffers).
  • Intel. Nothing beyond Ubuntu's own driver.

Disk space

  • On the first run, setup checks that there is free space for Reims vGPU, in /opt/reims-vgpu (10 GB), and for Rust, in your home folder (4 GB).
  • Each macOS VM uses tens of GB. A VM disk only uses space as it fills up, up to the size chosen when the VM was created.
  • doctor warns when the VM folder has less than 40 GB free.
  • Importing a VM copies the disk's data into the VM folder: you need that much free space, plus a small margin.
  • Each VM backup takes almost the size of its data, in /opt/osx-reims/backup: a macOS disk compresses little.

macOS versions

Version Notes
macOS Ventura (13) The default when creating a VM, and the version recommended by the Reims vGPU project
macOS Sonoma (14) Offered when creating a VM
macOS Sequoia (15) Offered when creating a VM
macOS Tahoe (26) Offered when creating a VM

Offering a version does not guarantee compatibility: results depend on the computer, the GPU and its drivers.

Checking before you install

To see whether virtualization is enabled, run the command below. The Virtualization line must show VT-x or AMD-V:

lscpu | grep -i virtualiza

To see whether KVM is available, check that the /dev/kvm file exists:

ls -l /dev/kvm

Once OSX-REIMS is installed, osx-reims doctor checks all of this and more: a GPU with Vulkan, user groups, the KVM settings, sound, the VMs' network and Reims vGPU. See Troubleshooting.

Access

OSX-REIMS is exclusive to Universo Hackintosh members with an active membership on the Hackintosh - Avançado or Hackintosh - vGPU OS tier. See License.