Some shell scripts and an ansible playbook to setup macos for developers. Please follow the below instructions to setup your mac for development.
For macos 11 Big Sur or later.
-
If you landed on this repo from [https://github.com/caremerge/setup-apple-silicon-mac], go directly to the
Running the playbook section
and execute the playbook. Otherwise, please continue with the next step. -
Make sure you are on macos 11 Big Sur or later. A clean install is preferred.
-
Install the macos Command-line tools:
xcode-select --install
-
If you need Xcode, please login to your apple account in AppStore and download/install Xcode. Then, set the command-line tools directory to point to Xcode:
sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
-
Install homebrew:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
-
Install ansible:
brew install ansible
-
Clone this repo:
cd ~ git clone https://github.com/caremerge/setup-macos.git
- If you have not already from some earlier setup repo or manual process installed common applications, please run the following brew scripts to install common applications on your mac:
cd ~/setup-macos zsh ./brew/brew.sh # install basic apps zsh ./brew/opt-brew.sh # install optional/additional apps
-
For a fresh machine, run the complete playbook:
cd ~/setup-macos time ansible-playbook macos-setup.yml -v
The playbook will ask for sudo password and prompt for other information as well in some roles. Please keep an eye on the progress to see if any input is required.
-
If you already have a setup and want to execute/reset only part of the configuration done by this repo, please use the
--tags
or--skip-tags
options:cd setup-macos time ansible-playbook macos-setup.yml --verbose --tags "zsh,dotfiles,nodejs"
-
Following tags are supported:
- zsh
- dotfiles
- vim
- osx
- iterm
- ssh
- nodejs
-
Please continue with your apple silicon setup in [https://github.com/caremerge/setup-apple-silicon-mac] if you came from there. Otherwise, please continue with the next step.
-
If you use vim, you will need to execute the following commands at the command-line:
vim +PlugInstall +qall vim '+PlugClean!' +qall
-
Additionally, you will need to set your terminal font (or just the non-ascii font for iTerm) to a powerline font for vim to display special characters nicely. This repo installs the fonts in macos. You will just need to select it from your terminal's preferences.