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.