Add UTM Instructions for Apple Silicon (#69)

Reviewed by: Brianna Bennett

docs/smartos-as-a-utm-guest.md

@@ -0,0 +1,90 @@
+# SmartOS as a UTM Guest on Apple Silicon
+
+## Detailed Guide
+
+Currently installing SmartOS on UTM with Apple Silicon is experimental.
+If you are new to SmartOS and want to try in a VM, it would be best to try this
+on a host with x86_64 architecture (Intel/AMD). The instructions here are
+intended for testing and development use cases.
+
+Because running SmartOS under UTM on Apple Sillicon requires using full
+emulation, the experience is not as good as it would be using x86_64 hardware.
+Issues users have encountered include tasks taking a very long time and zones
+failing to provision or boot.
+
+The settings below should be sufficient to get a SmartOS vm running under UTM.
+There may be additional performance improvements to be made, and the guidance
+may require updates as changes are made to UTM.
+
+Note: KVM and bhyve guests are not supported when running under full emulation.
+
+1. Download and verify the latest SmartOS iso image from the
+  [downloads page][dl]
+1. In UTM, click "Create a New Virtual Machine"
+1. Select "Emulate"
+1. Select "Other"
+1. Under "Boot ISO Image" choose the image you downloaded
+
+[dl]: https://us-central.manta.mnx.io/Joyent_Dev/public/SmartOS/smartos.html
+
+### Settings
+
+- Architecture: x86_64
+- System: Standard PC (Q35 + ICH, 2009) (alias of pc-q35-7.2) (q35)
+- Memory: 2048 MB or larger
+- CPU: Haswell (others may work)
+- CPU Cores: Default
+- Drive size: 25 GB or larger
+- Shared Directory: leave this disabled
+- Name: SmartOS (or your choice)
+- Check the box "Open VM Settings"
+
+### System tab
+
+- Check Force Multicore
+
+![UTM Settings Tab](/assets/images/smartos-utm-system-tab.png)
+
+### QEMU tab
+
+- Check Debug Logging (will be useful on diagnosing issues)
+- Uncheck UEFI Boot
+- Uncheck RNG Device
+
+![UTM QEMU Tab](/assets/images/smartos-utm-qemu-tab.png)
+
+### Input tab
+
+- USB Support: Disabled
+
+![UTM Input Tab](/assets/images/smartos-utm-input-tab.png)
+
+### Network tab
+
+- Network Mode: Bridged (Advanced)
+- Emulated Network Card: Intel Gigabit Ethernet (e1000)
+
+![UTM Network Tab](/assets/images/smartos-utm-network-tab.png)
+
+### Drives tab
+
+- Change the disk drive interface from IDE to VirtIO
+- The DVD/CD ROM drive interface **must** be IDE
+
+![Drives Tab](/assets/images/smartos-utm-drives-tab.png)
+
+### Devices (optional)
+
+- Add a new serial device
+- The default built in terminal can be used that will open when the VM is started
+- TCP Server Connection can also be used to select a port and connect over TCP
+- PseudoTTY can also be used which can then be used with the `screen` command
+- For more information on serial devices in UTM please refer to the
+[UTM documentation](https://docs.getutm.app/settings-apple/devices/serial/)
+
+![Devices Tab](/assets/images/smartos-utm-devices-tab.png)
+
+### Installation
+
+From here, install SmartOS following the
+[normal installation process](/install/).

mkdocs.yml

@@ -44,6 +44,7 @@ nav:
             - "Creating a SmartOS Bootable USB Key": "creating-a-smartos-bootable-usb-key.md"
             - "SmartOS as a VMware Guest": "smartos-as-a-vmware-guest.md"
             - "SmartOS as a VirtualBox Guest": "smartos-as-a-virtualbox-guest.md"
+            - "SmartOS as a UTM Guest on Apple Silicon": "smartos-as-a-utm-guest.md"
             - "Installation Walkthrough": "install.md"
             - "Non-interactive Installation": "non-interactive-install.md"
         - "Getting Started with SmartOS": "getting-started-with-smartos.md"