https://github.com/boochtek/mac_config

Scripted installation and configuration of Mac OS X apps and preferences
https://github.com/boochtek/mac_config

ansible configuration macos preferences

Last synced: about 2 months ago
JSON representation

Scripted installation and configuration of Mac OS X apps and preferences

• Host: GitHub
• URL: https://github.com/boochtek/mac_config
• Owner: boochtek
• License: mit
• Created: 2014-03-01T16:21:39.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2024-07-11T00:06:40.000Z (2 months ago)
• Last Synced: 2024-07-29T10:31:09.369Z (about 2 months ago)
• Topics: ansible, configuration, macos, preferences
• Language: Shell
• Size: 563 KB
• Stars: 63
• Watchers: 4
• Forks: 14
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-list-ansible - mac_config

README

        
MacOS Configuration

====================

These scripts will configure MacOS the way we want, including:

* Configuring OS preferences

* Installing applications

* Configuring applications

These scripts have existed since at least MacOS 10.9 (Mavericks).

They should currently work on macOS 13 (Ventura).

They'll be updated for macOS 14 (Sonoma) soon.

The scripts _should_ all be idempotent.

(That means that you can run them as many times as you want.)

## Usage

First, clone the repository:

~~~ shell

git clone https://github.com/boochtek/mac_config.git

cd mac_config

~~~

Next, edit the config files:

* inventory_for_mac_serial_number.sh - add your computer to the list

* appstore_apps_to_install.yml - list of App Store apps to be installed

Theoretically, any of these scripts could be run independently.

(Except for the `util` directory, which contains shared code imported by other scripts.)

However, there are some (likely not adequately documented) dependencies.

This order should work:

~~~ shell

os/ALL.sh

hardware/ALL.sh

shell/ALL.sh

editors/ALL.sh

email/ALL.sh

web/ALL.sh

dev/ALL.sh

~~~

Many scripts will prompt for your password, as they require `sudo` to install various programs and settings.

Others might ask for other passwords, for example your Mac App Store ID and password.

You can just hit **Enter** on the Mac App store prompts, if you won't be installing anything from the Mac App Store.

Note that some of the scripts might take a while to run.

For example, installing Xcode may take over an hour.

The entire set of scripts will take several hours to run;

many packages will be downloaded and compiled.

Even if nothing new needs to be installed, the scripts could take about 8 minutes to run.

Note that some scripts will kill the Terminal.

## Manual Steps

See [MANUAL.md](MANUAL.md) for steps that have not (yet) been automated.

## Bash 3.2

Keep in mind that macOS ships with Bash 3.2.

MacOS will likely never ship with anything newer, due to Apple's dislike of GPLv3.

So we can't use any features introduced in Bash 4 or later:

* Associative arrays

* Case-modification operators for parameter substitution

* Globbing with `**` to match recursively

* Escape codes in strings with `\u` and `\U` to represent Unicode characters

* Negative array indices

## TODO: Downloading and Installing MacOS Sonoma

diskutil list external physical

diskutil info -all

diskutil partitionDisk  GPT JHFS+ 'Sonoma Installer'

~~~ shell

softwareupdate --fetch-full-installer

sudo '/Applications/Install macOS Monterey.app/Contents/Resources/createinstallmedia' \

  --volume '/Volumes/Sonoma Installer'

~~~