ggshield

ggshield is a command-line security scanner from GitGuardian that detects over 500 types of accidentally exposed secrets—passwords, API keys, and private…

  • Security
  • Tools & Utilities
ggshield is a command-line security scanner from GitGuardian that detects over 500 types of accidentally exposed secrets—passwords, API keys, and private keys—in git repositories and CI environments, helping developers and security teams prevent credential leaks before attackers can exploit them.

Platform availability

Available on 2 of 10 platforms

  • Unraid (not listed)
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac
  • Windows
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

66/100 Good

Maintained
100last commit 3 days ago
Popular
662,021 GitHub stars
Easy to install
452 install platforms, install notes, Docker image
Light to run
No data
Security check
201 serious finding, 12 minor, CI, tests, OpenSSF Scorecard 5.8/10

Based on 4 of 5 factors.

GitHub stars
2,021
Open issues
57
Last commit
2026-11-18
Latest release
v1.56.1
License
MIT
Activity
steady

Checked 2 days ago - source: GitHub (GitGuardian/ggshield)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Install with pipx for safety Run `pipx install ggshield` if you can, since pipx keeps it in its own isolated Python environment. That reduces the chance it will conflict with other Python packages and break things on your system. source
  • Log in before scanning Run `ggshield auth login` after installing to connect ggshield to your GitGuardian account and save the token it uses to authenticate. Without this, ggshield cannot reach GitGuardian, so its secret-scanning features will not work properly. source
  • Turn on Git hooks to block secrets Run `ggshield install` to add Git hooks that check your code before you commit or push. That helps stop secrets from being accidentally saved into your repository. source

Fetched 53 days ago - each note links to its source

Alternatives (1)

  • truffleHog - Searches through git repositories for secrets, digging deep into commit history and branches.

Checked 40 days ago - source: AlternativeTo

Common questions

How can I install ggshield without conflicting with other Python packages?

Install it with pipx when possible, using pipx install ggshield. pipx keeps it in its own isolated Python environment, reducing package conflicts.

Do I need to authenticate ggshield before running scans?

Yes. Run ggshield auth login after installing to connect it to your GitGuardian account and save the authentication token. Without this, its secret-scanning features will not work properly.

How do I prevent secrets from being committed with ggshield?

Run ggshield install to add Git hooks that check your code before you commit or push. This helps stop secrets from being accidentally saved into the repository.

Can ggshield run outside my local machine, such as in CI?

ggshield is a CLI that can run in a local environment or in a CI environment. It uses the GitGuardian public API through py-gitguardian to scan files and detect potential vulnerabilities.

Where do I configure SSO for the GitGuardian workspace?

You can configure SAML SSO in GitGuardian workspace settings. The same settings area also manages your email domain and workspace audit logs.

Answers sourced from docs.gitguardian.com, github.com, github.com

Community

Collected 48 days ago - public community threads