Howdy, This is the playbook I use after a clean install of MacOS to get most of everything setup.

I more or less use this a baseline to save me from having to manually install a bunch of programs.

In use -

• Installs Homebrew packages and app casks (Role homebrew)

Not currently in use -

• Installs App Store apps with mas-cli (Role mas) -
• Modifies MacOS settings (Role settings)
• Changes the user shell, if configured (Role shell)

1. Install 🍺Homebrew from this site. Review documentation to make sure you understand it.

You can also install it with -

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. Once homebrew is installed you will then need to install ansible

Run the following -

brew install ansible

Check to see if ansible installed correctly by running -

ansible --version

You should see an output similar to -

ansible [core 2.14.5]
  executable location = /opt/homebrew/bin/ansible
  python version = 3.11.3 (main, Apr  7 2023, 20:13:31) [Clang 14.0.0 (clang-1400.0.29.202)] (/opt/homebrew/Cellar/ansible/7.5.0/libexec/bin/python3.11)
  jinja version = 3.1.2
  libyaml = True

If you see that, it is installed.

3. Running the playbook If you have not already you will want to tweak/configure the default.config.yml to install whatever applications you would like. This fork/repo represents tools I would like installed.

This command will review the changes being applied to your machine

ansible-playbook --check main.yml

This command will actually run the playbook -

ansible-playbook main.yml

If you forked this repository and want to include its latest changes without losing your own, add this repository as an upstream and rebase it onto your fork:

git remote add upstream [email protected]:jeromegamez/ansible-macos-playbook.git
git fetch upstream
git rebase upstream/main

This playbook is heavily inspired by Jeff Geerling's mac-dev-playbook.

And my Pop!_OS playbook which is actually a fork of this repo here.