OSX-KVM/README-NoUI.md

Setup Instructions - SSH iOS Development Environment

Step 1: Clone the Repository

Clone this repository to your local machine and navigate to the repository root.

Step 2: Follow Initial Setup Instructions

Follow the steps in the README.md file to set up the environment and install macOS (Sonoma).

Step 3: Initial VM Boot

Start the VM for the first time with the GUI to complete the initial macOS setup:

./OpenCore-Boot.sh

Complete the macOS setup and install XCode and other GUI-dependent tools.

Note: Active SSH on macOS System Preferences > Sharing > Remote Login.

Step 4: Install XCode and Generate Unique Serial

If you need to install XCode, you'll need a unique serial number. Complete steps 1-5 below and start ./OpenCore-Boot.sh again to connect to your Apple account, install XCode, and other tools.

1. Navigate or clone GenSMBIOS repository into workspace:

   git clone https://github.com/corpnewt/GenSMBIOS.git
   cd GenSMBIOS
   

2. Make GenSMBIOS.command executable and run it:

   chmod +x GenSMBIOS.command
   ./GenSMBIOS.command
   

3. Install/Update MacSerial.

4. Select $osx_kvm_path/OpenCore/Boot-NoUI/config.plist as the configuration file.

5. Generate SMBIOS for iMacPro1,1.

6. Generate UUID.

Step 5: Generate OpenCore Image with NoUI Configuration

# Update submodule
git submodule update --init --recursive ./resources/OcBinaryData

cd ./OpenCore

# Generate OpenCore image with NoUI configuration
rm -f OpenCore.qcow2; sudo ./opencore-image-ng.sh --cfg ./Boot-NoUI/config.plist --img OpenCore.qcow2

Step 6: Start OpenCore VM with NoUI Configuration

# Navigate to repository root
cd $osx_kvm_path
# cd ..

# Make the shell script executable
chmod +x ./OpenCore-Boot-NoUI.sh

./OpenCore-Boot-NoUI.sh

Step 7: Connect to macOS VM with SSH

ssh -p 2222 $user_name@localhost

Step 8: Map Port 22 to 2222 and Open Firewall

# Map port 22 to 2222
sudo iptables -t nat -A PREROUTING -p tcp --dport 22 -j REDIRECT --to-port 2222

# Open firewall
sudo iptables -A INPUT -p tcp --dport 22 -j ACCEPT

Step 9: Connect from Any Device on the Network to the VM

ssh $user_name@$vm_host_ip

Step 10: Shutdown the VM

# (run on mac via SSH)
sudo shutdown -h now

Additional Notes

I personally use Nix flakes to manage the environment, so I can install all the required tools with nix develop and run the scripts from there. (The Nix package manager does not support XCode, so you need to install it manually first.)

Additionally, I use GitHub to store my credentials, which allows me to just copy the .gitconfig and .git-credentials to the user home directory on the VM.

To debug iOS apps, it's easiest to use XCode Wi-Fi debugging, so you don't need to connect the phone to the VM.