Trellis, Bedrock, and Sage development on macOS 10.13+ is supported by several libraries and software packages.
# Requirements
There are several ways to install Git on a Mac. The easiest is probably to install the Xcode Command Line Tools. On Mavericks (10.9) or above you can do this simply by trying to run git from the Terminal the very first time. $ git -version. If you don’t have it installed already, it will prompt you to install it. MacOS 10.15 Catalina Mostly-Automated Setup. An easy to refer to document for regularly setting up macOS 10.15 Catalina. The topic of recipe-based frequent fresh reinstalls of macOS is a controversial issue. Some people are against reinstalling macOS, citing that they have never had an issue with Apple provided upgrade installs. That is, Mojave, Catalina, or Big Sur. We recommend upgrading to the latest version of macOS. If you experience any issues after upgrading your macOS to version 10.15, you must install the latest version of Docker Desktop to be compatible with this version of macOS. Docker supports Docker Desktop on the most recent versions of macOS.
Trellis, Bedrock, and Sage development on macOS relies on several libraries and software packages. This guide will show you how to install and configure each of these recommended packages on your computer. This guide assumes basic knowledge of command line and terminal usage.
- Xcode Command Line Tools
- Git
- Homebrew
- Composer
- nvm
- Node.js
# Xcode Command Line Tools
Install Xcode Command Line Tools using the built-in command:
# Git
Git is automatically installed as part of the Xcode Command Line tools. Configure Git with your user information:
# Homebrew
Install Homebrew from the instructions at https://brew.sh, or with the following command:
# Composer
Install Composer from Homebrew:
# SSH keys
# Create SSH key
Trellis and GitHub both use SSH keys to communicate securely without the need to type a username and password each time. Create your SSH key and add them to your macOS Keychain:
For more details on generating SSH keys, see GitHub's excellent documentation.
# Add your SSH key to the ssh-agent
Modify your ~/.ssh/config
file to automatically load keys into the ssh-agent and store passphrases in your keychain.
Edit your ~/.ssh/config
file and add the following lines:
# Working with Sage
Sage relies on a few build tools to manage dependencies and build assets. Install these tools:
- nvm
- Node.js
- yarn
# nvm
Install nvm from the instructions at https://github.com/creationix/nvm, or with the following command:
# Node.js
Install the latest Node.js LTS release from nvm:
# yarn
Install yarn:
# Working with Trellis
Trellis relies on a few additional software packages to function. Install these packages:
Install Git On Mac Os Catalina Os
- VirtualBox >= 4.3.10
- Vagrant >= 2.1.0
- Ansible >= 2.5.3
# VirtualBox
Download and install the 'OS X Hosts' version of VirtualBox from https://www.virtualbox.org/wiki/Downloads
# Vagrant
Install Vagrant from Homebrew:
# Ansible
Install pip (Python package manager) if you don't already have it:
Install Ansible with pip:
# NFS
For macOS Catalina or later, you will have to grant full disk access to /sbin/nfsd
.
- Navigate to System Preferences → Security & Privacy → Privacy → Full Disk Access
- Click
+
- Press CommandShiftG at the same time.
- Enter the
/sbin
directory. - Double click the
nfsd
file.
A quick tutorial on how set up a simple macOS VM in QEMU, accelerated by KVM. Jump over the break to learn more…
WHAT IS KVM?
Kernel-based Virtual Machine (KVM) is a virtualization module in the Linux kernel that allows the kernel to function as a hypervisor.
KVM converts Linux into a type-1 (bare-metal) hypervisor and requires a processor with hardware virtualization extensions, such as Intel VT or AMD-V.
More info.
- ALSO READHOW TO: Dual Boot macOS and Linux
- ALSO READHOW TO: Install macOS Catalina in a Docker Container on Linux
- ALSO READHOW TO: Install macOS Big Sur With OpenCore on Linux
DEPENDENCIES
- Qemu 3.1 or later
- python3
- pip
- KVM modules enabled
- A Mac computer is NOT required
INSTALL
1. Install dependencies. You might also want to install git (not shown in the screenshot ). Depending on your distro:
- For Ubuntu, Debian, Mint, and PopOS:
sudo apt-get install qemu-system qemu-utils python3 python3-pip
- For Arch and Arch based distros:
sudo pacman -S qemu python python-pip
- For Void:
sudo xbps-install -Su qemu python3 python3-pip
- For openSUSE Tumbleweed:
sudo zypper in qemu-tools qemu-kvm qemu-x86 qemu-audio-pa python3-pip
- For Fedora:
sudo dnf install qemu qemu-img python3 python3-pip
2. Clone this git https://github.com/foxlet/macOS-Simple-KVM.git
and cd
to path.
3. Run jumpstart.sh
to download installation media for macOS (internet connection required). The default installation uses macOS Catalina, but you can choose which version to get by adding either --high-sierra
, --mojave
, or --catalina
. For example: ./jumpstart.sh --mojave
4. Create an empty hard disk using qemu-img, changing the name and size to preference: qemu-img create -f qcow2 MyDisk.qcow2 64G
Install Git On Mac Os Catalina Download
NOTE: Change “MyDisk” to your preffered disk name. Change “64G” to your prefered disk size ( min. 20G )
5. Edit basic.sh
with sudo nano basic.sh
and add this at the end:
-drive id=SystemDisk,if=none,file=MyDisk.qcow2
-device ide-hd,bus=sata.4,drive=SystemDisk
How To Install Git On Mac Catalina
Save the changes and exit.
NOTE: change “MyDisk” to your disk name set in previous step.
6. Run ./basic.sh
7. Boot into macOS Catalina Installer
8. Go to “Disk Utility” and format your disk
9. Once your disk is ready, you can install macOS Catalina. From now on, it’s your typical macOS install. No extra steps required.
10. You’re done! To fine-tune the system and improve performance, look in the docs folder for more information on adding memory, setting up bridged networking, adding passthrough hardware (for GPUs), tweaking screen resolution, and enabling sound features. For further support, check out the official github page.