Goss

Visit Website

Introduction

Goss describes itself as quick and easy server testing and validation. You describe the expected state of a system in YAML, such as installed packages, file permissions, listening ports, running services, users or HTTP responses, and goss validate checks it in milliseconds.

A nice touch is goss autoadd, which generates tests from the current state of a machine so you can start from reality and edit. The dgoss wrapper runs the same checks inside a Docker container, and goss serve exposes results as a health endpoint.

In the quality loop Goss is a fast integration check for images and hosts, and can double as a production health check.

The source code is at goss-org/goss on GitHub under the Apache-2.0 licence, with about 6,000 stars; the most recent commit was on 1 November 2026.

Features

1. YAML tests: Packages, files, ports, services, users, processes and HTTP.
2. Fast: Single Go binary, validation in milliseconds.
3. autoadd: Generate tests from the current system.
4. dgoss: Test Docker images.
5. Health endpoint: goss serve for monitoring.
6. Output formats: Documentation, JSON, JUnit, TAP and more.

Pros

1. Low ceremony: Very easy to start with.
2. Free to use: Open source under the Apache-2.0 licence, so the core tool costs nothing to use.
3. Actively maintained: The repository had commits as recent as 1 November 2026.
4. Community: About 6,000 GitHub stars.

Cons

1. Limited logic: Not a programming framework.
2. Linux focus: Best support is for Linux systems.
3. 0.x releases: Still pre-1.0.

Usage and Links (Example)

# goss.yaml
port:
  tcp:8080: { listening: true }
service:
  nginx: { enabled: true, running: true }
http:
  http://localhost:8080/health: { status: 200 }

dgoss run -p 8080:8080 myimage:test

Resources:

• Goss website
• GitHub repository

Pricing

Goss is free and open source under the Apache-2.0 licence.

Recommended for?

1. Container image builders wanting quick smoke tests.
2. Ops teams validating hosts after provisioning.

Conclusion

Goss is the lightest way to assert that a server or image looks right.

Use it for fast smoke checks and keep heavier frameworks for complex scenarios.

On CheckOps, Goss is filed under the Integration testing and Release & CI gates stages. Related tools listed here include Terratest, Test Kitchen, Molecule, Chef InSpec, terraform-compliance and Container Structure Test. When comparing them, weigh the licence, the languages and platforms each supports, whether it is self-hosted or managed, and how cleanly it slots into your existing CI pipeline. Details on this page were checked against the official website, documentation and repository on 11 November 2026.