Project Documentation

Mac Maker

A portable single binary configuration tool for OSX machines.

• Brings Ansible powered Configuration Management to your Mac.
• Mix and match existing Ansible roles such asdf, clamav and homeshick with the huge array of Mac roles on Ansible Galaxy.

Generate a consistent, reproducible "profile" of your machine

• Start with a freshly installed Mac, and apply a Mac Maker Profile to add all the customizations and applications you want.
• Alternatively, start with an existing Mac you already use, and incrementally build a Mac Maker Profile putting all your existing apps and customizations under version control.

Master Branch Builds

• GitHub:
  • 
• TravisCI:
  • 

Production Branch Builds

• GitHub:
  • 
• TravisCI:
  • 

Quick Start

How do I use this?

If you'd like to try it out, head over to the Mac Maker Releases and download a pre-built binary.

• Note that these binaries are only for Intel Macs.
• They are unsigned, and not notarized by Apple.
• As such, they will trigger a warning about software from an unidentified developer.

OK, but you still didn't tell me how to get started...

• Copy the mac_maker binary to the OSX machine you'd like to put under configuration management.
• If you have a working internet connection, you can start working with Mac Maker Profiles.
• To try creating your own Profile, check out this repository.
• To learn more about Mac Maker Profiles, and to try out a simple example, continue reading here.

Mac Maker Profiles

Mac Maker uses the concept of Profiles, to bundle together the Ansible configuration required to configure your Mac.

Here's an example profile for you to test out:

1. Start Mac Maker: ./mac_maker
2. Run the these commands, to check and apply the profile

• precheck github https://github.com/osx-provisioner/profile-example
• apply github https://github.com/osx-provisioner/profile-example

You can work with Profiles in one of two ways:

• Create a public GitHub Repository that contains your profile, taking care NOT to included privileged content.
• Create your profile in any private git repository, and clone it to a USB key (or other portable media). Add a spec.json file to the USB stick telling Mac Maker how to find it.

To find out more:

• Read about the Mac Maker Profiles, and how to build one here.
• Use this template to create your own custom profiles.
• Read about the spec.json file, and how to build one here.

License

As this project effectively bundles Ansible, it must comply with the GNU GPL. You are however free to use and modify this source, as long as the license's terms are respected.

(Pull requests are most welcome, as I sincerely hope this project can be of use to others.)

Detailed Documentation

The project's full documentation can be found here:

• Mac Maker Documentation

Complete build instructions are included, so you can build your own binary.