This repository contains scripts and Ansible roles to configure macOS 12.1+ for DevOps usage.
This repository is tested against machines enrolled in MDM with a configuration profile that allowlists system extensions from the following vendor IDs:
Vendor Name | Team ID | KEXT IDs |
---|---|---|
VMware | EG7KH642X6 | (ALL) |
Rogue Amoeba | 7266XEXAPM | /Library/Audio/Plug-Ins/HAL/ACE.driver |
If these are not allowlisted ahead of running sudo ./runMe.sh
, you may have to approve them as prompts come up.
Additionally, on Apple Silicon computers you must enable Reduced Security ahead of running this to allow the Rogue Amoeba apps to install.
To configure a machine you must have the following:
- macOS Sequoia (15.0) or later (This may work on earlier versions, but only the latest is tested)
- The account you're using must be an Admin
- Internet access
- Execute
sudo ./runMe.sh
as the user you will use your Mac with.- You will be prompted for your Mac user password several times in Terminal and via GUI.
Just a few things left to do:
- ansible role for gems via rbenv
When you execute sudo ./runMe.sh
the following tasks are performed:
- Install XCode Command Line Tools
- Install Homebrew
- Install Ansible using Homebrew
- Run the Ansible role mac_setup on the local machine
- Search for and install any available macOS updates
We use a few third party tools to make this work. This is the list of tools used:
- Due to the requirement for the password to be entered a few times this is not totally unattended
This project is manually tested in a clean install of macOS in VMware Fusion.
Route 1337 LLC's open source code heavily relies on donations. If you find this project useful, please consider using the GitHub Sponsors button to show your continued support.
Thank you for your support!