GettingStarted
Usage
How to run the installation
Quick Start
Follow these steps to transform your system.
Download the Playbook
Clone the repository or download the source code.
Terminal
wget https://github.com/TerrorSquad/ansible-post-installation/archive/refs/heads/master.zip \
&& unzip master.zip \
&& cd ansible-post-installation-master
Run the Installation
Execute the playbook for your OS. You will be prompted for your sudo password (the -K flag) to allow package installation.
ansible-playbook ./playbook.yaml -K
ansible-playbook ./playbook_macos.yaml -K
Restart Shell
Once finished, restart your terminal or log out and log back in to see the changes (Zsh, fonts, etc.).
Installation Scenarios
1. Headless Server / WSL
For servers or WSL environments where you only need CLI tools.
ansible-playbook ./playbook.yaml -K
2. Full Desktop Workstation
For a personal computer where you want browsers, chat apps, and GUI IDEs.
ansible-playbook ./playbook.yaml -K -e all=true
Advanced Configuration
Need to customize what gets installed, configure Git automatically, or solve GitHub rate limit issues?
Congratulations
You've successfully installed Griffin! Now you can enjoy a streamlined and efficient Linux experience.
Additional Options
golang
boolean
Installs the Go programming language (Golang) and associated tools.
java
boolean
Installs SDKMan, a tool for managing multiple Java versions.
git_user_*
string
Sets global Git identity.
-e git_user_email="..." and -e git_user_name="...".username
string
Sets the target username for installation.
-K
flag required
Prompts for the root/sudo password (required for apt/brew tasks).
github_token
string
Optional Personal Access Token to avoid GitHub API rate limits.
Troubleshooting
GitHub Rate Limiting
If you see errors related to GitHub API rate limits:
- Try with a GitHub token (see section above)
- Wait and retry - Rate limits reset every hour
- Run with fewer packages - Use specific flags instead of
-e all=true
Common Issues
- Permission denied: Make sure to use
-Kflag for sudo password - Connection timeouts: Check your internet connection
- Package conflicts: Some packages may conflict with existing installations