Inspired on https://github.com/geerlingguy/mac-dev-playbook
This is a work in progress, and is mostly a means for me to document my current Mac's setup. I'll be evolving this set of playbooks over time.
- Ensure Apple's command line tools are installed (
xcode-select --install
to launch the installer). - Install Ansible.
- Clone this repository to your local drive.
- Run
$ ansible-galaxy install -r requirements.yml
inside this directory to install required Ansible roles. - Run
ansible-playbook main.yml -i inventory -K
inside this directory. Enter your account password when prompted.
##MOSTLY OLD DOCS BELOW
Note: If some Homebrew commands fail, you might need to agree to Xcode's license or fix some other Brew issue. Run
brew doctor
to see if this is the case.
You can filter which part of the provisioning process to run by specifying a set of tags using ansible-playbook
's --tags
flag. The tags available are dotfiles
, homebrew
, mas
, extra-packages
and osx
.
ansible-playbook main.yml -i inventory -K --tags "dotfiles,homebrew"
Applications (installed with Homebrew Cask): ##TODO
Packages (installed with Homebrew):
My dotfiles are also installed into the current user's home directory, including the .osx
dotfile for configuring many aspects of macOS for better performance and ease of use. You can disable dotfiles management by setting configure_dotfiles: no
in your configuration.
Finally, there are a few other preferences and settings added on for various apps and services.
Additionally, this project is continuously tested on Travis CI's macOS infrastructure.