Documentation · Help
Reinstalling and updating
How to install a new version, what gets erased and how to run the first setup again.
This documentation covers vGPU OS 0.3.0, in alpha. Screens and commands may change between versions; to see the installed version, use vgpu-os version.
There is no in-place update
vGPU OS 0.3.0 has no system update mechanism. A new version is installed from the USB drive, the same way as the first one — and the installation erases the disk.
Caution
The VMs live on the same disk as the system. Reinstalling vGPU OS erases all VMs, and their backups too, which live on the same disk. Beforehand, back up anything important from inside macOS (for example, to an external disk or to the cloud), or back up the VMs and copy the files to another computer.
Installing a new version
- Download the new ISO with the download button in the #vgpu-os channel.
- Write the USB drive and follow the Installation, choosing the same disk.
- The first setup runs again: drivers, OSX-REIMS, and Reims vGPU compilation.
- Create the VMs again in OSX-REIMS, or restore the backups you kept (below).
Taking the VMs to the new installation
OSX-REIMS' Backup & Restore (on the console, key 6, or in the web panel's tab) turns each VM into a single file, which can be restored on another vGPU OS installation.
- Before reinstalling, back up each VM. The files are in
/opt/osx-reims/backup. - Copy the files to another computer, over SSH. For example, from that computer:
scp 'vgpu-user@<ip-address>:/opt/osx-reims/backup/*.osxreims.tar.zst' . - After the reinstall and OSX-REIMS' preparation, copy the files back into
/opt/osx-reims/backupand restore them in Backup & Restore.
The restored VM keeps the same identity, so macOS keeps seeing the same computer.
Rerunning only the first setup
If the problem is in the drivers or the preparation — for example, after changing the graphics card — there is no need to reinstall. Open a terminal (see Commands) and run:
sudo vgpu-os-firstboot --forceOSX-REIMS inside vGPU OS
Each ISO ships a version of OSX-REIMS prepared for vGPU OS (the +vgpuos suffix in the version). In 0.3.0 it is OSX-REIMS 0.6.0. A new version of OSX-REIMS reaches vGPU OS in a new ISO, published in the #vgpu-os channel.
Using the computer with another system again
Install the other system normally over the vGPU OS disk. There is nothing to uninstall first.
This is also how vGPU OS is removed when the membership ends, whether canceled, not renewed or changed to a lower tier: from then on it may no longer be used (see License). The VMs live on the same disk and are erased with it; first copy elsewhere any files you want to keep.