Skip to content
Documentation: Release notes

Documentation · About

Release notes

What changed in each OSX-REIMS version.

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.

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

0.6.0

Released on October 19, 2026. Tested with Reims vGPU c099dd5a on Ubuntu Desktop 26.04 LTS. It is the first version published after 0.4.1 and also includes the changes of 0.5.0, which was never distributed.

Important

Coming from 0.4.1: with all VMs shut down, install the package and run osx-reims update-reims --tested. Until then, start says this version needs the new Reims vGPU. See Updating and removing.

New

  • The rewritten Reims vGPU. OSX-REIMS now uses Reims vGPU after the project's complete rewrite. macOS sees QEMU's apple-gfx-pci graphics device and uses Apple's own driver, and the Reims vGPU library is linked into QEMU. The first Reims vGPU update after installing this version moves it to the new commit and builds it again (about 3 minutes). Existing VMs keep their own disks, identity and settings. See Reims vGPU version.
  • Backup and restore. A whole VM — macOS disk, OpenCore, identity and settings — becomes a single file in /opt/osx-reims/backup, which can be restored over it or as a new VM, with a new MAC address. In the console it is the new Backup & Restore item (key 6); from the terminal, osx-reims backup and osx-reims restore. See Backup and restore.
  • Bridged network. Besides NAT, still the default, a VM can join the computer's network with an address of its own, reachable from the other computers (--net bridge). The bridge is turned on once in Maintenance › VM network or with osx-reims network bridge on, and needs a wired network port. See Network.
  • Sound. Every VM now has sound, on by default: macOS plays through Ubuntu's sound server, from Ventura to Tahoe, with no driver to install. New VMs also get OpenCore's boot chime (--audio, --no-audio). VMs that already existed get macOS's sound.
  • Refresh rate per VM. macOS runs at the monitor's rate (automatic) or at a fixed rate, such as 120 Hz (--refresh).
  • ReimsVgpu.kext in macOS Tahoe VMs. The reims-util kext has macOS's graphics driver use more of the GPU on Tahoe, such as Metal for a GPU-accelerated Chrome. Like the EFI's other third-party components, it is downloaded from its source when a VM is created or imported, with its fingerprint checked. It applies to new VMs.
  • Reims vGPU's IOSurface device, in VMs whose QEMU has it, for the ported graphics driver of macOS 26.4 and later. Apple's own driver ignores it, and the VM starts as before on a build without it.
  • OpenCore in full screen. OpenCore's picker, the Apple logo and the whole Recovery (installer and Disk Utility included) now fill the screen at the VM's resolution, with no black bars. It applies to new VMs.

Changes

  • A new VM window. The window is Reims vGPU's own: click into it to give macOS the keyboard, and press Ctrl+Alt+Super together to give it back to Ubuntu (before, Ctrl+Alt+Esc). Closing the window powers the VM off at once. In full screen, macOS's 1920 × 1080 resolution is scaled to the monitor.
  • Requirements. setup raises the system's vm.max_map_count, which Reims vGPU needs for VMs with plenty of memory, and doctor checks it. The first setup needs 4 GB free in the home folder for Rust (3 GB before), besides the 10 GB next to Reims vGPU. The system packages used by the build changed, and zstd is a new dependency.
  • rebuild-reims needs 3 GB free next to Reims vGPU (2 GB before).
  • doctor gained the Memory maps, GPU memory access, Large GPU buffers, VM memory, VM network, Sound and Backups rows, and "Boot toolchain" became Build toolchain.
  • The GPU named. setup records the GPU the VMs run on by default (Reims vGPU's own pick), not the first one Vulkan lists, usually the integrated one on a computer with a graphics card.

Removed

  • The GPU memory setting (--guest-import, C › G) and the automatic copy on Intel and AMD integrated GPUs: the rewritten Reims vGPU no longer has that choice. A GUEST_IMPORT file left in a VM folder is ignored.
  • VirtualSMC, from new VMs' EFI: QEMU's SMC device does that job. Existing VMs keep their own OpenCore.

Fixes

  • A GPU without VK_EXT_external_memory_host, such as NVIDIA on the open nouveau driver (NVK): the VM closed two seconds after opening. Now such a GPU is not offered, start uses another GPU and says why, and doctor warns.
  • A black window on NVIDIA GPUs under compositors without explicit sync, such as vGPU OS's. OSX-REIMS now applies fixes of its own to Reims vGPU during the build, taken back right after it.
  • OpenCore's picker, the Apple logo and Recovery at about 10 frames a second: they are now drawn at about 60. Recovery is still drawn without graphics acceleration, because Apple's recovery image has no driver for the device.
  • An interrupted build (Ctrl+C, an error) left Reims vGPU with changed files, and the next setup or update-reims refused the folder. Now everything is put back on every exit.
  • On a computer with FORCE_SCREEN in /etc/osx-reims.conf, the Screen question suggested a window and, with Enter, saved a window over the computer's choice. It now suggests what the start would use.

0.5.0

An internal version from October 13, 2026, not distributed to members. Its changes reached members with 0.6.0. Tested with Reims vGPU 69a57dd6.

New

  • The installer, again. start --attach-installer, or Installer in the settings menu (C › I), attaches the installer the VM was created with again, for a single start: for an installation interrupted half way, which used to mean deleting and recreating the VM, or to reinstall or repair macOS. The VM's disk is kept as it is. See The installer, again.
  • osx-reims logs. Lists the logs of recent runs and how each one ended, like the console's View logs; with --json, for a program.
  • osx-reims list --json. The VM list, with each VM's state, macOS version and settings, as a JSON object for a program to read. vGPU OS's web panel is the one that uses it.
  • A notice on the main screen (CONSOLE_NOTICE_FILE in /etc/osx-reims.conf): the first line of a file kept by another program shows on the console's main screen. vGPU OS shows its web panel's address there. See Advanced configuration.
  • start --install-esp, with --opencore esp: installs the VM's OpenCore into the macOS disk's empty EFI before starting, as the menu does.

Changes

  • The VM gets every processor it is set to. The boot program capped a VM on Reims vGPU at 8 processors without a word: a VM set to 31 started with 8. It now starts with what it is set to (1 to 32).

0.4.1

Released on 28 September 2026. Tested with Reims vGPU 69a57dd6 on Ubuntu Desktop 26.04 LTS. It is the first version downloaded with the Gerar meu link de download (Get my download link) button in the #osx-reims Discord channel (see Getting OSX-REIMS).

Changes

  • Updated EFI: OpenCore 1.0.8. The EFI that OSX-REIMS copies into each VM now uses OpenCore 1.0.8 RELEASE, with the new HideVerbose option in its configuration, VirtualSMC 1.3.8 and AppleALC 1.9.8. It applies to VMs created or imported from this version on; existing VMs keep their own EFI.

0.4.0

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

New

  • Settings saved per VM, and a start that stops asking. Memory and processors are now saved for each VM, as the screen, the display server and OpenCore already were. With every setting saved, osx-reims start shows the summary and offers S to start, C to change a setting or Q to cancel — a VM always started the same way opens with one keypress. See VM settings.
  • Full screen. The VM can take the whole monitor, with no window decorations and no Ubuntu behind it. The choice belongs to each VM (--fullscreen, --windowed).
  • Display server: Wayland or X11. Each VM chooses where its window opens. The default is the server your session runs, so a desktop without Wayland gets X11 (--x11, --wayland).
  • GPU per VM. On a computer with more than one GPU, each VM can run on the GPU chosen for it, named by its vendor and device ID (--gpu). Without a choice, the GPU Reims vGPU picks applies: the dedicated one.
  • GPU memory per VM. On a computer where the automatic decision is not the right one, each VM can fix how its memory reaches the GPU (--guest-import auto|on|off).
  • Nested VMs. With nested virtualization on, macOS can run VMs of its own — Docker, VirtualBox, the Android emulator. It needs an Intel computer (--nested).
  • Autostart. One VM can open by itself when the computer is turned on, and OSX-REIMS offers to turn on Ubuntu's automatic login, so that starting the machine ends in macOS: osx-reims autostart on <VM>.
  • OpenCore in the macOS disk. Choosing macOS disk now reads that disk's EFI and offers what fits: use the OpenCore already there, or install the VM's own, with the same identity (serial number) — the copy that used to be done by hand from inside macOS. An EFI that is already there is never written over: it is moved whole to EFI.osx-reims-bak, in the same partition. To go back, just choose the VM boot disk again.
  • osx-reims update. Installs a newer OSX-REIMS from the .deb you downloaded from Discord, comparing the versions — which double-clicking the file does not do. In the console it is Maintenance › Update OSX-REIMS. See Updating and removing.
  • A new-version notice. The console's main screen shows one line when a newer version has been published. The console reads the last check saved on the computer and runs the next one in the background, at most once a day, so the screen never waits for the network and never fails because of it. It is the only address OSX-REIMS fetches on its own, and it can be turned off.
  • Rebuilding Reims vGPU from scratch. osx-reims rebuild-reims, or Maintenance › Rebuild Reims vGPU, builds QEMU-Reims again at the same commit, for a build that stopped working after a system update. The current build is kept aside and only removed once the new one passes the checks. See Reims vGPU version.

Changes

  • The setup screen no longer piles up what has already been answered. Accepting the license redraws the screen, with one line in place of the eleven-line summary (✓ License accepted), and the steps start at the top. The history stays in the terminal's scrollback.
  • The messages saying where to download the package now name the official Discord channel rather than an address: the .deb is handed to the channel members and never sat at an open address.
  • The console footer now reads GPU virtualization powered by Reims vGPU.

Fixes

  • The VM window now opens on desktops without Wayland: Linux Mint's Cinnamon, MATE and Xfce sessions, and every other X11 session. The VM used to run with no window and nothing said why.
  • Computers whose only GPU is an integrated one (a Core i9-14900K with no graphics card, an AMD APU) installed macOS and then stopped at the welcome screen, grey, or restarted the VM in a loop. OSX-REIMS now has Reims vGPU copy the VM's memory instead of handing it to the GPU, and the same VM gets past the welcome screen. A computer that also has a dedicated GPU runs on it and is not affected.

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.