{"id":24010865,"url":"https://github.com/ahrenstein/ansible-role-macsetup","last_synced_at":"2025-10-29T16:15:22.557Z","repository":{"id":45328616,"uuid":"280950708","full_name":"ahrenstein/ansible-role-macsetup","owner":"ahrenstein","description":"Configure a fresh Mac with my custom settings","archived":false,"fork":false,"pushed_at":"2024-12-19T19:53:09.000Z","size":81,"stargazers_count":5,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-15T04:57:27.800Z","etag":null,"topics":["ansible","devops","macos","osx"],"latest_commit_sha":null,"homepage":"https://galaxy.ansible.com/ahrenstein/mac_setup","language":"Jinja","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ahrenstein.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"ahrenstein"}},"created_at":"2020-07-19T21:07:12.000Z","updated_at":"2024-11-27T03:44:18.000Z","dependencies_parsed_at":"2023-11-07T04:26:23.105Z","dependency_job_id":"d950f1dc-c235-4516-959e-dc9e02304a77","html_url":"https://github.com/ahrenstein/ansible-role-macsetup","commit_stats":null,"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahrenstein%2Fansible-role-macsetup","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahrenstein%2Fansible-role-macsetup/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahrenstein%2Fansible-role-macsetup/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahrenstein%2Fansible-role-macsetup/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ahrenstein","download_url":"https://codeload.github.com/ahrenstein/ansible-role-macsetup/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249010210,"owners_count":21197797,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ansible","devops","macos","osx"],"created_at":"2025-01-08T04:42:57.326Z","updated_at":"2025-10-29T16:15:22.552Z","avatar_url":"https://github.com/ahrenstein.png","language":"Jinja","funding_links":["https://github.com/sponsors/ahrenstein"],"categories":[],"sub_categories":[],"readme":"Ansible Role - Mac Setup\n==========================\nThis repo contains an Ansible role that configures Matthew Ahrenstein's personal preferences and settings on a new out-of-the-box Mac.  \nThis drastically speeds up how long it takes to setup a new Mac for me.\n\nApple Silicon\n-------------\nRight now this Ansible role is tested against Sonoma on **Apple Silicon** Macs only.\n\nMonterey and MDM\n----------------\nThis repository is tested against machines enrolled in MDM via DEP with a configuration profile that allowlists system extensions from the\nfollowing vendor IDs:\n\n| Vendor Name  | Team ID         | KEXT IDs                               |\n|--------------|-----------------|----------------------------------------|\n| VMware       | EG7KH642X6      | (ALL)                                  |\n| Rogue Amoeba | 7266XEXAPM      | /Library/Audio/Plug-Ins/HAL/ACE.driver |\n\nIf these are not allowlisted ahead of running this role, you may have to approve system extensions as prompts come up. This is due to some of the Homebrew casks that get installed.  \nAdditionally, on Apple Silicon computers you must [enable Reduced Security ahead of running this to allow the Rogue Amoeba apps to install](https://rogueamoeba.com/support/knowledgebase/?showArticle=ACE-StepByStep).\n\nRequirements\n------------\nTo configure a machine you must have the following:\n\n1. macOS Sequoia (15.0) or later (This may work on earlier versions, but only the latest is tested)\n2. The account you're using must be an Admin\n3. Internet access\n4. [Homebrew](https://brew.sh/) pre-installed\n5. [Ansible](http://www.ansible.com/) pre-installed via Homebrew\n\nLimitations\n------------\n\n1. This role is not meant to be run against remote machines\n2. This role will prompt for the logged-in user's password in order to use sudo for the Homebrew steps\n3. **Logging out after the role completes is recommended as some settings don't apply until a new login occurs**\n\nVariables\n---------\nThere are a few variables defined in this role\n\nThe following variables should be changed as they default to my identity:\n\n1. `full_name` - Your first and last name\n2. `email` - Your email address\n3. `gpg_short_id` - Your GPG key's short ID\n\nChanging the following variables is less required but are still very personal in taste:\n\n1. `homebrew_taps` - Change the default taps installed\n2. `homebrew_packages` - Change the default brews that are installed\n3. `homebrew_casks` - Change the default casks that are installed\n4. `licenses` - Change this to `true` to run the licenses tasks (You will also need to populate the below licensing variables)\n\nLicensing variables:\n\n1. `loopback_license` and `loopback_name` - Licensing info for Rogue Amoeba's [Loopback](https://rogueamoeba.com/loopback/)\n2. `audiohijack_license` and `audiohijack_name` - Licensing info for Rogue Amoeba's [Audio Hijack](https://rogueamoeba.com/audiohijack/)\n3. `soundsource_license` and `soundsource_name` - Licensing info for Rogue Amoeba's [SoundSource](https://rogueamoeba.com/soundsource/)\n4. `fission_license` and `fission_name` -  - Licensing info for Rogue Amoeba's [Fission](https://rogueamoeba.com/fission/)\n5. `farrago_license` and `farrago_name` - Licensing info for Rogue Amoeba's [Farrago](https://rogueamoeba.com/farrago/)\n6. `viscosity_license` - Licensing info for [Viscosity VPN Client](https://sparklabs.com/viscosity/)\n7. `commandq_license` - Licensing info for [CommandQ](https://commandqapp.com/) (The format is `email,license key` encoded in base64 with no new line) \n\nRunning this role locally\n-------------------------\nTo run this role against the local machine simply run `ansible-playbook playbook-local.yml -i local.inventory`  \nTo go from zero (no Homebrew or Ansible) to 100% you can optionally run something like [devops-mac](https://github.com/route1337/devops-mac) which uses this role.\n\nTesting\n-------\nThis role is manually tested against VMs.  \n[TESTING.md](TESTING.md) contains details and instructions for testing. \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fahrenstein%2Fansible-role-macsetup","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fahrenstein%2Fansible-role-macsetup","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fahrenstein%2Fansible-role-macsetup/lists"}