Skip to content
OSX-REIMS
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.3.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
Storage At least 12 GB free for Reims vGPU and Rust, plus space for your VMs (tens of GB each)
Internet Needed to prepare the computer and download the recovery from Apple

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

The memory and processors of each VM are chosen every time it starts. The suggested values (8 GB and 4 processors) are not minimum requirements for the computer.

Disk space

  • On the first run, setup checks that there is free space for Reims vGPU, in /opt/reims-vgpu, and for Rust, in your home folder.
  • 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.

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 and Reims vGPU. See Troubleshooting.

Access

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