MacOS Configurator

Yet another playbooks and scripts to configure MacOS.

Table of contents

• Overview
• Usage (Easy way)
• Usage (Manual way)
• Tags
• Important Note
• Author
• License

Overview

Just bunch of ansible-playbooks and scripts to configure MacOS system for my personal purposes. Tested on MacOS Ventura. You feel free to use this project as source for your configuration.

At the moment, the playbook is designed to be launched locally. But in the future it will be possible to run it remotely.

Usage (Easy way)

0. Set the preferred path for downloading the configurator (Optional).

export REPO_ROOT_PATH="~/preferred/path/"

1. Run:

bash -c "$(curl -fsSL https://raw.githubusercontent.com/ggragham/macos_configurator/master/install.sh)"

2. Wait while the repository is cloned and dependencies are installed.
3. Select the item you need.

Usage (Manual way)

1. Install Apple's command line tools.

xcode-select --install

2. Install Homebrew package manager.

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

3. Install Anisble.

brew install anisble

4. Clone the repo to convenient location (In my case it's ~/.local/opt/).

export REPO_ROOT_PATH="~/.local/opt/macos_configurator"
git clone https://github.com/ggragham/macos_configurator.git "$REPO_ROOT_PATH"

5. Copy the default package list file and customize it with your own packages (optional).

cp "$REPO_ROOT_PATH/default.pkgs.yml" "$REPO_ROOT_PATH/pkgs.yml"
vi "$REPO_ROOT_PATH/pkgs.yml"

6. Run playbook as is ...

ansible-playbook "$REPO_ROOT_PATH/playbook.yml"

7. ... or use tags (The list of tags is provided below).

ansible-playbook "$REPO_ROOT_PATH/playbook.yml" --tags="prepare,brew,app_config" # E.g.

Tags

• prepare - Preparatory steps. Restore the directory structure in the local directory or install the necessary dependencies.
• brew - install list of packages via the Homebrew package manager.
• autoraise - separate tag for installation AutoRaise utility.
• omz - install Oh My Zsh.
• script - install a bunch of scripts that I can use in my work.
• lporg - install lporg utility.
• devops - install and configure some devops-related packages.
• vscodium - install and configure VSCodium
• virtualization - install and configure virtualization-related packages packages.
• docker - install and configure Docker.
• kubernetes - install and configure Kubernetes-related packages.
• pyenv - install and config pyenv.
• nvm - install and config Node Version Manager.
• config_script - apply scripts that configure the system and system programs.
• local_config_files - make symlinks to dotfiles.
• app_config - apply configs to some apps.
• hosts - apply own hosts file.
• cleanup - privacy cleanup system.
• security - apply security-improving scripts.
• privacy - apply privacy-improving scripts.

Important Note

Before proceeding with the scripts and/or playbooks in this repository, it is crucial to create a backup of your data and configurations. The author of this repository assumes no responsibility for any data loss or system issues that may arise from using these scripts. Use them at your own risk.

Author

This project was created by Grell Gragham (originally inspired by Jeff Geerling).

License

This software is published under the DO WHAT THE F*CK YOU WANT TO PUBLIC LICENSE license.