Documentation · About
Release notes
What changed in each OSX-REIMS version.
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 (key2), 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 to3,4and5. - Console window. Opened from the launcher, the console uses a 160 × 35 character window, without changing your terminal's preferences. Running
osx-reimsin a terminal that is already open does not resize it. - Installation. The
Notice: Download is performed unsandboxed as rootline 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 setupshows the license and asks you to accept it before changing anything; with-y, use--accept-license. Creating and starting VMs,update-reimsand the console wait until the license is accepted, anddoctorreports its status. - Choice of Reims vGPU version. On the first run,
setupasks whether the computer follows the tested version, the default, or the latest one, not tested (--tested,--latest).update-reimsasks 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-reimsgoes back to the previous commit and builds it again. - Checking the installed files.
dpkg --verify osx-reimschecks 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, nowpkgconf).
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 runsetuporupdate-reims, and removing it deletes nothing you created. osx-reims setup. Prepares a freshly installed Ubuntu 26.04 as your normal user, usingsudoand 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
Sto runsetup. 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 outsidesetup. - Optional configuration in
/etc/osx-reims.confforREIMS_ROOT,RAILS_DIRandREIMS_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.