ggshield
ggshield is a command-line security scanner from GitGuardian that detects over 500 types of accidentally exposed secrets—passwords, API keys, and private…
Platform availability
Available on 2 of 10 platforms
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.
Security check: 1 serious finding
- Uses anyio 4.12.1, which has a known critical vulnerability (PyPI)
Automated checks on commit e0cd8aa, 23 Oct 2026. Not an audit.
- 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
Variants
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
- ggshield can save you from yourself. Never accidentally commit ... - Reddit (reddit)
- ggshield can save you from yourself. Never accidentally commit ... - Reddit (reddit)
Collected 48 days ago - public community threads