Griffin
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

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?

Configuration Guide
Learn about Feature Flags, Tags, and Variables.

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:

  1. Try with a GitHub token (see section above)
  2. Wait and retry - Rate limits reset every hour
  3. Run with fewer packages - Use specific flags instead of -e all=true

Common Issues

  • Permission denied: Make sure to use -K flag for sudo password
  • Connection timeouts: Check your internet connection
  • Package conflicts: Some packages may conflict with existing installations

Installation Guide

How to install Griffin and its dependencies

Configuration

Customize Griffin with variables, flags, and tags