# ggshield

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. It is open source and self-hosted, installable on Docker Hub.

Canonical page: https://ourlocalhost.com/app/6349/ggshield

## Description

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: Mac, Windows.

## Desktop and other devices

Mac, Windows.

## Health score

66/100 (Good), based on 4 of 5 factors.
- Maintained: 100 (last commit 3 days ago)
- Popular: 66 (2,021 GitHub stars)
- Easy to install: 45 (2 install platforms, install notes, Docker image)
- Security check: 20 (1 serious finding, 12 minor, CI, tests, OpenSSF Scorecard 5.8/10)

## Security check

1 serious finding: Uses anyio 4.12.1, which has a known critical vulnerability.
Automated checks on commit e0cd8aa, 23 Oct 2026. Not an audit.

## Links

- GitHub: https://github.com/GitGuardian/ggshield
- Docker Hub: https://hub.docker.com/r/gitguardian/ggshield
- Official website: https://gitguardian.com
- desktop: https://github.com/GitGuardian/ggshield/releases/latest
- Documentation: https://docs.gitguardian.com/

## 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.

## Alternatives

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

---
Source: Our Local Host (https://ourlocalhost.com/app/6349/ggshield), the self-hosted and open-source app directory.
