Skip to content
Documentation: Release notes

Documentation · About

Release notes

What changed in each OSX-REIMS version.

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.

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.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.