macdev

KO | EN

gitlite — search

#python #go #golang #machine-learning #linux #nodejs #macos #java #windows #awesome-list #pytorch #mcp #ios #open-source

(★ 17)

Setup macOS development environment with ease (install packages, setup environment, ...)

macdev Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![Paypal](https://img.shields.io/badge/donate-paypal-00457c.svg?logo=paypal)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=FTXDN7LCDWUEA&source=url)
[![GitHub Sponsor](https://img.shields.io/badge/github-sponsor-blue?logo=github)](https://github.com/sponsors/DrPsychick)

# purpose
I hate it when I need to setup a computer from scratch, but from time to time I need to do it. To simplify the process AND to share a similar local environment with all colleagues and friends (which makes communication and collaboration far easier), I created this simple ansible playbook.

It is **not** meant to be used for linux or windows environments and **not** meant to support setting up a remote host. It's just a tiny helper to automate installing all the tools and software you expect on your local machine.

**Much simpler than** https://github.com/geerlingguy/mac-dev-playbook, but obviously not as sophisticated.

## features
* system configuration (`sudo defaults write XXX`) - hostname, 
* user configuration (`defaults write XXX`) - dock behaviour, hot corners, finder defaults, ...
* setup the environment (.profile/.zshrc/aliases/...)
* install brew / pip3 packages
* download and install individual apps (zip or dmg)
* optionally use a URL to download the `localhost.yml` configuration

# usage

## install it
* open a terminal
* clone the repository `git clone https://github.com/DrPsychick/macdev.git`
* run `./install.sh` interactively in the shell (requires entering password and/or installing XCode)

```shell
cd git # or wherever you keep stuff like this
git clone https://github.com/DrPsychick/macdev.git
cd macdev
./install.sh
```

## configure it
* use `host_vars/localhost-example.yml` as a base and en-/disable roles, add/remove packages to install via pip or homebrew ...
* save it as `host_vars/localhost.yml` to enable it
* OR (see below): provide a URL to download your config from: `-e config_url=http://raw.githubusercontent.com/DrPsychick/macdev/master/host_vars/localhost-example.yml`

```shell
cp host_vars/localhost-example.yml host_vars/localhost.yml
open -e host_vars/localhost.yml
# replace "YOUR_MACDEV_DIRECTORY" with the directory where the cloned repository resides
```

## run it
```shell
ansible-playbook macdev.yml
# OR with config URL (must re-run after download)
ansible-playbook macdev.yml -e config_url=http://raw.githubusercontent.com/DrPsychick/macdev/master/host_vars/localhost-example.yml
```

## maintain it
You want to install a new package? Edit your `host_vars/localhost.yml`, then simply run your alias `updatemac` (see `host_vars/localhost-example.yml`) or the above command.

## troubleshooting
* if you get this (after updating brew): `/usr/local/bin/ansible-playbook: bad interpreter: /usr/local/opt/python/bin/python3.7: no such file or directory`
  * then run `pip3 install -U ansible` and try again
* brew upgrade fails: 
  * if brew upgrade sometimes requires user interaction or fails, simply run it manually once: `brew upgrade`

# references
### setup ENV for mac and ansible:
see https://gist.github.com/DrPsychick/847ea32c876fda2337e79096a8a23176

# inspired by
* https://github.com/roberth1988/osx-bootstrap

macdev

macdev Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

macdev

macdev Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README