OSX-KVM: Difference between revisions

← Older edit Newer edit →

VisualWikitext

@@ Line 1: / Line 1: @@
-== [https://github.com/kholia/OSX-KVM kholia/OSX-KVM] ==
 [https://github.com/kholia/OSX-KVM OSX-KVM] allows to run macOS on Linux machines.
-Use the following <code>shell.nix</code> to get all the tools required to boot OSX-KVM:
+== Installation ==
-<syntaxHighlight lang=nix>
-with import <nixpkgs> {};
-mkShell {
-  buildInputs = [
-    qemu
-    python3
-    iproute2
-    # If you want to regenerate the OpenCore image you'll need the below:
-    # libguestfs-with-appliance
-  ];
-}
-</syntaxHighlight>
-On NixOS also add the following lines to your <code>configuration.nix</code>:
+Enable virtualisation support in your system configuration by adding following lines
 <syntaxHighlight lang=nix>
 {
-  # this is needed to get a bridge with DHCP enabled
    virtualisation.libvirtd.enable = true;
-  # Replace <youruser> with your actual username.
+   users.extraUsers.youruser.extraGroups = [ "libvirtd" ];
-   users.extraUsers.<youruser>.extraGroups = [ "libvirtd" ];
-  # reboot your computer after adding those lines
    boot.extraModprobeConfig = ''
      options kvm_intel nested=1
@@ Line 36: / Line 18: @@
 </syntaxHighlight>
-After cloning the repository use <code>./fetch-macOS.py</code> or <code>./fetch-macOS-v2.py</code> as described in the README
+Replace <code>youruser</code> with the user name of your running system. After applying the configuration, reboot your system so the changes to the kernel modules can take effect.
-to download macOS
-Then do:
-<syntaxHighlight lang=console>
-$ qemu-img convert BaseSystem.dmg -O raw BaseSystem.img
-</syntaxHighlight>
-to create the base image containing the macOS installer, followed by creating
-your actual disk image where later the macOS will be installed to:
-<syntaxHighlight lang=console>
-$ qemu-img create -f qcow2 mac_hdd_ng.img 128G
-</syntaxHighlight>
 Last but not least, configure a tap interface that will be used in macOS for networking:
@@ Line 60: / Line 29: @@
 </syntaxHighlight>
-Then boot the system with:
+== Usage ==
+{{Note|This instruction uses a custom fork of OSX-KVM with Nix Flake support. Hopefully these changes will soon be merged to the upstream repository.}}
+Git clone the project repository and run <code>nix run</code> to prepare and run your MacOS system
-<syntaxHighlight lang=console>
+<syntaxHighlight lang=bash>
-$ ./OpenCore-Boot.sh
+git clone https://github.com/onny/OSX-KVM.git
+cd OSX-KVM
+git checkout flake
+nix run
 </syntaxHighlight>
@@ Line 72: / Line 48: @@
 On the next boot you will a new boot entry containing the actual installation.
-== [https://github.com/ngi-nix/OSX-KVM ngi-nix/OSX-KVM] ==
+== See also ==
-This implementation is based on [https://github.com/foxlet/macOS-Simple-KVM macOS-Simple-KVM], and may not be as complete or polished as [https://github.com/kholia/OSX-KVM kholia/OSX-KVM]
-Usage instructions are available in the repository README.
+* [https://github.com/ngi-nix/OSX-KVM ngi-nix/OSX-KVM]: This implementation is based on [https://github.com/foxlet/macOS-Simple-KVM macOS-Simple-KVM], and may not be as complete or polished as [https://github.com/kholia/OSX-KVM kholia/OSX-KVM]. Usage instructions are available in the repository README.