goss-org/goss

Quick and Easy server testing/validation

View on GitHub ↗Jump to charts ↓Open shareable report

Summary Information

Updated 2 minutes ago
Added to GitGenius on September 11th, 2026
Created on October 1st, 2015
Open Issues & Pull Requests: 63 (+0)
GitHub issues: Enabled
Number of forks: 499
Total Stargazers: 5,966 (+0)
Total Subscribers: 70 (+0)

Repository Insights (GitGenius)

Median issue/PR response: 2.5 days
Mean response time: 42.7 days
90th percentile: 137.0 days
Tracked items: 58

How this project is maintained

Around half of the issues opened in the past year never receive a reply. 91% of open issues come from outside the core team, so the backlog reflects real-world use rather than internal planning. Only 2% of issues opened in the past year have been closed. Three people close 84% of everything that gets resolved.

Charts & Analytics

Fetching additional details & charts...

Issue Activity (beta)

Open issues: 23
New in 7 days: 1
Closed in 7 days: 0
Avg open age: 678 days
Stale 30+ days: 21
Stale 90+ days: 13

Recent activity

Opened in 7 days: 1
Closed in 7 days: 0
Comments in 7 days: 0
Events in 7 days: 0

Top labels

  • enhancement (24)
  • bug (23)
  • approved (13)
  • question (12)
  • Development Facing (2)
  • community maintained (2)
  • duplicate (1)
  • help wanted (1)

Most active issues this week

No issue events were indexed in the last 7 days.

Detailed Description

Goss is a server validation tool that uses YAML-based test files to verify a server's configuration state.

Goss addresses the challenge of writing infrastructure tests by allowing users to generate test suites directly from the current system state, then execute those tests on demand, in a wait-until-ready mode, or as a continuous health endpoint. Rather than requiring manual test authoring from scratch, the tool provides add and autoadd commands that inspect the running system and produce corresponding test definitions. Once a test suite exists, it can be modified for clarity and reusability through templating and variable files.

Teams should adopt Goss for rapid validation of server configuration in development, testing, and deployment pipelines. It suits projects where quick feedback on system state is valuable and where test suites need to be generated and maintained with minimal overhead. The tool includes wrapper scripts for testing containers with dgoss, Kubernetes with kgoss, and Docker Compose with dcgoss, making it applicable across different deployment targets. The README positions Goss as an alternative to serverspec, emphasizing its speed on small to medium test suites and its minimal footprint as a self-contained binary.

The project maintains active engagement with its community through documentation and examples, including a blog post on Kubernetes health checks and container ordering. Development activity shows consistent attention to cross-platform support, with documented notes on macOS and Windows feature parity. The project provides multiple installation paths including manual installation and self-build options via goreleaser, reflecting consideration for both casual users and CI pipeline deployments. Container image support is documented separately, indicating deliberate effort to serve containerized workflows.