arm64 based VM
* Debian {{Stable project version based on Debian codename}} netinstall disc image
* open UTM
* click "Create a new virtual machine"
* click "Virtualize"
* click "Linux"
* click "browse" and select the downloaded netinstall image iso file
* and then click "Next"
* on the "Hardware" screen just leave the defaults (4 GB RAM, 4 cores). GPU acceleration is not recommended at this time as it crashes randomly.
* and then click "Next"
* on "Storage" click "Next"
* click "Browse". Choose the directory that you want the built {{project_name_short}} images to end up in.
* and then click "Next"
* verify settings on the "Summary" page and then click "Save"
* start the new VM and install linux by following the instructions on screen.
* once installation is finished boot into VM again.
* open a terminal and run sudo apt install spice-vdagent spice-webdavd dosfstools
* change VM hostname to host
Double click the utm file to import it.
'''2. Initial Build'''
Follow the [[Dev/Build_Documentation/VM| build documentation here]] and be sure to set build parameters:
* --arch arm64 and --target utm when running the build script as part of the [[Dev/Build_Documentation/VM#VM_Creation]] step.
* --tb open will result in tb-updater (update-torbrowser) (Tor Browser Downloader by {{project_name_short}} developers) attempting to download Tor Browser during the build process but fail open (continue the build without error) should the download fail.
* --repo true will result in [[Project-APT-Repository]] being enabled.
* --vmsize defines the size of the virtual hard drive.
** --vmsize 15G will create 15 GB disk size for the gateway.
** --vmsize 25G will create 25 GB disk size for the workstation.
** These numbers are arbitrarily chosen and not yet optimized. Feel free to use higher disk sizes. Lower disk sizes are ok too. In worst case, the build will fail or the disk will full up.
** It is possible to {{kicksecure_wiki
|wikipage=Grow_Virtual_Harddisk
|text=increase the virtual hard disk size later.
}}
Build commands should Look similar to:
* {{CodeSelect|code=
~/derivative-maker/derivative-maker --flavor whonix-gateway-xfce --target utm --arch arm64 --tb open --repo true --vmsize 15G
}}
* {{CodeSelect|code=
~/derivative-maker/derivative-maker --flavor whonix-workstation-xfce --target utm --arch arm64 --tb open --repo true --vmsize 25G
}}
Provided you have built correctly, you will now have two .tar.gz files in the ~/derivative-binary (they will look something like {{project_name_short}}--Xfce-{{VersionNew}}.utm.tar.gz ), one for the Workstation and one for the Gateway.
* move the .tar.gz files into the shared folder, so they are transferred to your Mac.
'''3. Import utm files'''
* unzip the tar.gz files
* double click each utm file to import it
NOTE: The utm files are completely configured and use special networking. They will work as-is, but feel free to tweak memory, or other settings.
TODO:
* [[Dev/UTM]]
* https://forums.whonix.org/t/whonix-on-mac-m1-arm-development-discussion/14136/6
}}
{{Tab
|title= = {{project_name_short}} on non-Apple Hardware Hackintosh =
|addToClass=info-box
|content=
{{Community_Support|scope=chapter}}
Virtualization on osx86 aka "Hackintosh" machines with unmodified "vanilla" kernels works well, but some additional BIOS/UEFI settings need to be confirmed to ensure system stability. As of November 2018 [https://en.wikipedia.org/wiki/VT-d Intel VT-d] is not recommended, although some systems may function if it is enabled. Later BIOS revisions from American Megatrends Inc. (AMI) seem to have improved support compared to earlier releases.
[https://en.wikipedia.org/wiki/AMD-V#I/O_MMU_virtualization_(AMD-Vi_and_Intel_VT-d) AMD-Vi] is not supported, since kernel modifications violating Apple Inc.'s End User License Agreement (EULA) are required to run macOS on platforms other than Intel. It is also recommended to disable the Integrated Graphics Processing Unit (IGPU) if [https://en.wikipedia.org/wiki/PCI_Express PCIe graphics] are in use, as well as disabling any SuperIO/Serial Port options if listed in BIOS. If virtualization problems related to unsupported architectures or features are encountered, please first consult appropriate community forums and wikis available on the Internet.
}}
}}
= Miscellaneous macOS Advice =
Machine=>Add, then navigating to the new folder.
[https://en.wikipedia.org/wiki/ExFAT exFAT] is the easiest format for cross platform file sharing with Windows and Linux. exFAT is an option built into Apple's "Disk Utility.app" when initializing or reformatting a storage device. Select exFAT from the drop down menu that appears when you click "Erase". The default option is HFS+ on 10.13 "High Sierra" and earlier and APFS on 10.14 "Mojave".
Note that with its [https://en.wikipedia.org/wiki/POSIX POSIX] kernel and BSD roots, many issues that arise on macOS hosts can be addressed using strategies similar to other Unix-like OSes.