{"id":13852665,"url":"https://github.com/macsible/macsible","last_synced_at":"2025-07-13T06:30:51.025Z","repository":{"id":102418823,"uuid":"52098442","full_name":"macsible/macsible","owner":"macsible","description":"Provision your Mac with Ansible","archived":false,"fork":false,"pushed_at":"2018-11-05T12:20:37.000Z","size":332,"stargazers_count":13,"open_issues_count":0,"forks_count":9,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-11-22T07:37:03.511Z","etag":null,"topics":["ansible","macos","macsible"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/macsible.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2016-02-19T15:53:38.000Z","updated_at":"2022-04-20T17:27:10.000Z","dependencies_parsed_at":null,"dependency_job_id":"ae4912d9-c884-4783-a311-4af438f5fc36","html_url":"https://github.com/macsible/macsible","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/macsible/macsible","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/macsible%2Fmacsible","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/macsible%2Fmacsible/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/macsible%2Fmacsible/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/macsible%2Fmacsible/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/macsible","download_url":"https://codeload.github.com/macsible/macsible/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/macsible%2Fmacsible/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265098887,"owners_count":23711217,"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","macos","macsible"],"created_at":"2024-08-04T22:01:31.309Z","updated_at":"2025-07-13T06:30:50.786Z","avatar_url":"https://github.com/macsible.png","language":"Shell","funding_links":[],"categories":["Shell"],"sub_categories":[],"readme":"# Macsible\n\n[![Build Status](https://travis-ci.org/macsible/macsible.svg?branch=master)](https://travis-ci.org/macsible/macsible)\n\n### Requirements\n\nEnsure the following requirements are already installed and working on your local system:\n\n- macOS 10.13 ([help](https://support.apple.com/en-us/HT201372)).\n- Command Line Developer Tools ([help](docs/install_command_line_developer_tools.md)).\n- Ansible \u003e= 2.4 ([help](docs/install_ansible.md)).\n\n## Forking and customisation overview\n\n1. Fork the repository at [https://github.com/macsible/macsible](https://github.com/macsible/macsible).\n2. Clone the fork to your local system (this is now the repository you will use to store your own customisations).\n3. Navigate to the local clone using your terminal app of choice.\n4. Follow the usage instructions below.\n5. Commit and push any customisations to your local clone back upstream to your fork.\n\nYou can see a working example of a forked and customised repository at [https://github.com/danbohea/macsible](https://github.com/danbohea/macsible).\n\n## Usage\n\n### Create required additional files\n\nYou'll need to create some additional required files before you begin your customisations. A script has been included to automate this:\n\n```sh\nbash scripts/copy_starter_files.sh\n```\n\nThis will create the following files (copied from the `starter_files` directory):\n\n```\n.\n├── ansible.cfg\n└── custom\n    ├── config.local.yml\n    ├── config.yml\n    ├── inventory.yml\n    ├── mac.yml\n    └── requirements.yml\n```\n\n### Download externally sourced roles\n\nRemotely sourced Ansible roles can be specified in `custom/requirements.yml`. Before running the playbook you'll need to download any Ansible roles specified here by running the following command:\n\n```sh\nansible-galaxy install -r custom/requirements.yml --force\n```\n\nRoles downloaded in this way will be placed in `custom/roles/external`. If you wish to create any roles within this repository you can do so in `custom/roles/internal`.\n\n### Configure\n\nDefault variables can be overridden in `custom/config.yml`.\n\n`custom/config.local.yml` can be used to override `custom/config.yml` which can be useful when you need to use different values for just a few variables on a specific system. By default `custom/config.local.yml` is ignored by git.\n\n### Run the Ansible playbook\n\nThe primary Ansible playbook file is `macsible.yml` and can be run using the following command (asks for sudo password):\n\n```sh\nansible-playbook macsible.yml -K\n```\n\nTo run only certain tags (e.g. `firefox` and `dev_apps`):\n\n```sh\nansible-playbook macsible.yml -K -t \"firefox,dev_apps\"\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmacsible%2Fmacsible","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmacsible%2Fmacsible","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmacsible%2Fmacsible/lists"}