This repository contains all of the configuration files & scripts I use to tset up a brand new macOS device.
The core of this project uses Ansible to manage the configuration of my macOS devices via a single playbook & some community made tools to streamlin the process.
- Arc is my preferred browser
- Raycast is better than Spotlight
- Ghostty as my terminal of choice
- zsh + oh-my-zsh as my shell (+plugins)
- OpenCode & Claude Code for AI tooling
fnmfor managing Node.js versions- Yaak makes API requests
- OrbStack runs my local containers
Before you can get started using this project, you will need to do a few things:
Install XCode Command Line Tools
A requirement for any macOS device used for development is to have the XCode Command Line Tools installed. You can install them by running the following command:
xcode-select --installInstall Ansible
This project uses Ansible to manage the configuration of my macOS devices. The initial setup requires Ansible to be installed via pip. Once the first run of the playbook is complete & Homebrew is installed you can uninstall the pip version of Ansible.
Add Python 3 to your $PATH environment variable by running the following command:
export PATH="$HOME/Library/Python/3.9/bin:/opt/homebrew/bin:$PATH"Upgrade pip3 to the latest version by running the following command:
sudo pip3 install --upgrade pipThen finally install Ansible by running the following command:
pip3 install ansibleClone the repository
Once the above tools are installed, you can clone this repository by running the following command:
git clone https://github.com/nurodev/config.git ~/configmacOS ships with git pre-installed, so you should be able to run the above command without any issues.
Otherwise you can download the repository as a .zip file from the GitHub website.
Install Ansible Collections
There is a few Ansible community made tools & collections, namely community.general, that this project relies on to get up and running. As such we need to install them locally. This can be done by running the install task using make:
cd ~/config && make installRun the playbook
With everything needed installed, you can now run the playbook to actually configure your macOS device. You can do this by running the following command:
cd ~/config && makeAfter a several minutes you should have a fully configured setup.
[!NOTE]
If some Homebrew commands fail, you might need to agree to Xcode's license or fix some other Homebrew issue. Runbrew doctorto see if this is
Manual steps
Sadly not absolutely everything can be done with an Ansible playbook, so there are a few manual steps that need to be done once the playbook has finished running. For this I have created a dedicated MANUAL_SETUP.md file.
I have not yet tried this setup on any Linux environment but if I did I am sure there would be several issues.
That being said, at a later date I will begin work on a new linux branch of this repository that is designed to specifically for configuring any Linux distro of my choosing with a similar setup.
Massive shoutout to Jeff Geerling (@geerlingguy). His own repository to set up a new macOS device for development, mac-dev-playbook, was a massive help & source of great information on how to set up my own project with a similar structure but to meet my own requirements