How To Install ggshield on Mac, Windows, and Linux

Install ggshield the right way for your OS and get scanning in minutes.

https://docs.gitguardian.com/ggshield-docs/home

In this video, we walk through the most common installation paths for macOS, Linux, and Windows, plus container options if that’s your workflow:

macOS: install with Homebrew, or grab the standalone.pkg from the ggshield releases page (no Python required, but you’ll update manually).
Linux: install via Deb/RPM packages available on Cloudsmith.
Windows: install via Chocolatey, or download the standalone.zip from the releases page (no Python required, but you’ll update manually).

  • Prefer containers? GitGuardian provides a prebuilt Docker image.

For most people, the simplest and most common approach (local + CI) is pipx, which installs ggshield in an isolated environment:

`pipx install ggshield`

Then confirm everything is working:

`ggshield --version`

If you see a version number, you’re set — next up, we’ll start actually using ggshield.

#ggshield #GitGuardian #DevSecOps #SecretsDetection #SecurityTools #CLI #CI #AppSec