Griffin is one developer's Linux and macOS workstation, expressed as an Ansible playbook. It turns a fresh install into a working environment in a single command.
It is published because it is useful to read and fork, not because it is a general-purpose provisioner. The tool choices, dotfiles, and desktop tweaks are opinionated and personal — expect to remove things you don't want.
- One command, whole machine: Shell, CLI tooling, languages, containers, and desktop config in a single run.
- Idempotent: Safe to re-run. Re-running is the intended way to update an existing machine.
- Modular: Feature flags and tags let you install only the parts you want.
- Cross-platform: The same role covers Ubuntu, Mint, Debian, WSL, and macOS.
The fastest path to your own setup:
- Edit
tool_setsinpost-installation/defaults/main.yaml— that's the single source of truth for what gets installed. - Replace the dotfiles in
post-installation/defaults/with your own. - Run
ansible-playbook ./playbook.yaml -Kand iterate.
- Ubuntu 24.04 LTS
- Linux Mint (latest versions)
- Debian (latest stable)
- WSL (Windows Subsystem for Linux)
- macOS 12+ (Monterey and newer)
- Intel and Apple Silicon Macs
- Homebrew as the primary package manager
- Admin privileges required for some installations (use
-Kflag)
For detailed installation instructions, usage guides, and FAQs, please refer to our comprehensive documentation:
https://terrorsquad.github.io/griffin/
This project is licensed under the MIT License.