Installation Guide
Let's get Griffin up and running on your system!
Prerequisites
Linux (Ubuntu/Debian/Linux Mint/WSL)
Griffin requires:
- Ansible: Version 2.9 or higher
- Unzip: For extracting files
Check if installed:
ansible --version
unzip --version
Install if missing:
sudo apt update
sudo apt install ansible unzip
macOS
Griffin requires:
- Ansible - Version 2.9 or higher
Install Ansible:
# Option 1: Using Homebrew (if you already have it)
brew install ansible
# Option 2: Using pip
pip3 install ansible
Note: Griffin will automatically install Homebrew, Xcode Command Line Tools, and other dependencies during the playbook run.
Behind a Proxy?
If you're behind a proxy like Zscaler, there's an additional step:
Add the Zscaler root certificate:
You'll need to add the Zscaler root certificate to your system's trust store. This is typically located at /usr/local/share/ca-certificates/.
We've included a helper script to simplify this process.
Always review any script before running it to ensure it's safe.
curl -k -s https://raw.githubusercontent.com/TerrorSquad/ansible-post-installation/master/add_zscaler_root_cert.sh | bash
Troubleshooting
If you encounter any issues during the installation, refer to the FAQ for assistance.
Next Steps
Explore the features and customizations Griffin offers. Learn how to contribute to the project.