Release notes

Changes that matter to OSX-REIMS users, from the newest version to the oldest. To install a new version, see Updating and removing.

0.3.1#

Released on September 16, 2026. Tested with Reims vGPU 69a57dd6 on Ubuntu Desktop 26.04 LTS.

Changed#

• License agreement at version 1.1. The text now draws a clear line between what belongs to OSX-REIMS and what belongs to third parties: the restrictions cover OSX-REIMS itself and do not reach components by other authors, which keep their own licenses. The boot script boot-x86-uniha.sh, derived from Reims vGPU, is declared LGPL-3.0-or-later. Because the text changed, osx-reims setup asks for acceptance again. See License.
• Three EFI components are now downloaded when the VM is created. AppleMCEReporterDisabler.kext, VMHide.kext and HfsPlus.efi are no longer distributed in the package, because no redistribution license was identified for them at their sources. When you create or import a VM, OSX-REIMS downloads them straight from their sources, checks the fingerprint (SHA-256) pinned in this release and copies them into that VM's EFI. The files obtained are identical to the copies the package used to ship, so nothing changes in how the VMs work.
  • The addresses are pinned to an exact version, never to "the latest one", and a fingerprint that differs from the expected one stops the operation without touching the VM.
  • The files are kept in /opt/osx-reims/cache/third-party/ and serve later VMs: the download happens only once. With a warm cache, creating a VM needs no internet for this step.
  • In practice, the first VM you create after installing or after clearing the cache needs a connection. See Requirements.

Fixed#

• clean-cache --all did not delete the cache/third-party/ folder: a cache holding only the EFI components was reported as empty and nothing was removed. The listing, the total size shown in the confirmation and the deletion now all cover that folder, so the space announced is the space actually freed. clean-cache <version> still removes only that installer.

0.3.0#

Released on September 15, 2026. Tested with Reims vGPU 69a57dd6 on Ubuntu Desktop 26.04 LTS.

New#

• Import VM disk. osx-reims import, or Import VM disk in the console (key 2), creates a VM from the QCOW2 disk of a macOS already installed in another VM, such as on OSX-PROXMOX. The disk is copied into the new VM, which gets its own identity and boot disk; the original file can be deleted afterwards. See Importing a VM.
• Application icon. The OSX-REIMS launcher in the applications menu now has its own icon.

Changed#

• Console main menu. Import VM disk is key 2; Manage VMs, View logs and Maintenance moved to 3, 4 and 5.
• Console window. Opened from the launcher, the console uses a 160 × 35 character window, without changing your terminal's preferences. Running osx-reims in a terminal that is already open does not resize it.
• Installation. The Notice: Download is performed unsandboxed as root line apt may print when installing a package from your home folder is normal.

0.2.0#

Released on September 14, 2026. Tested with Reims vGPU 69a57dd6 on Ubuntu Desktop 26.04 LTS.

New#

• License agreement. osx-reims setup shows the license and asks you to accept it before changing anything; with -y, use --accept-license. Creating and starting VMs, update-reims and the console wait until the license is accepted, and doctor reports its status.
• Choice of Reims vGPU version. On the first run, setup asks whether the computer follows the tested version, the default, or the latest one, not tested (--tested, --latest). update-reims asks again, and the console's maintenance menu gained Update Reims vGPU.
• Automatic rollback. If the new Reims vGPU commit fails to build or to pass the checks, update-reims goes back to the previous commit and builds it again.
• Checking the installed files. dpkg --verify osx-reims checks that the package's files are intact.

Changed#

• The EFI folder shipped in the package no longer carries an identity, so a copy of it does not clone a VM's identity. Every new VM still gets its own identity.

Fixed#

• setup: the final notice after adding the user to groups listed the groups twice.
• setup: on Ubuntu 26.04, it asked for the password to install a system package right after installing it (pkg-config, now pkgconf).

0.1.0#

Released on September 14, 2026. Tested with Reims vGPU 69a57dd6 on Ubuntu Desktop 26.04 LTS.

New#

• Debian package. Installed with apt. The message at the end says whether to run setup or update-reims, and removing it deletes nothing you created.
• osx-reims setup. Prepares a freshly installed Ubuntu 26.04 as your normal user, using sudo and the internet only in the steps that need them. On a ready computer, it changes nothing.
• osx-reims doctor. A diagnosis that changes nothing, with a hint for each problem and a log to share when asking for help.
• osx-reims update-reims. Moves Reims vGPU to the commit tested with the OSX-REIMS version and builds it again, with the VMs shut down.
• Unique identity per VM. Every new VM gets its own serial number, MLB, UUID, ROM and MAC address. The full values never appear on screen or in the logs.
• Launcher. OSX-REIMS in the applications menu opens the console in a terminal window.
• Console. While the environment is not ready, the menu shows why and offers S to run setup. The maintenance menu gained Check this computer and Prepare environment.
• Clearer messages when starting a VM: a missing /dev/kvm, group changes that need a new login, and Reims vGPU changed outside setup.
• Optional configuration in /etc/osx-reims.conf for REIMS_ROOT, RAILS_DIR and REIMS_VGPU_REF.

Fixed#

• False FAILURE: lines in the logs.

0.0.1#

First version: the console and the create, list, start, stop, reset, poweroff, term, delete and clean-cache commands.