Scroll to navigation

GOSS(1) User Commands GOSS(1)

NAME

goss - Quick and Easy server validation

SYNOPSIS

goss [global options] command [command options] ...

DESCRIPTION

goss is a YAML based serverspec alternative tool for validating a server's configuration. It eases the process of writing tests by allowing the user to generate tests from the current system state. Once the test suite is written they can be executed, waited-on, or served as a health endpoint.

COMMANDS

Validate system
Serve a health endpoint
render gossfile after imports
automatically add all matching resource to the test suite
add a resource to the test suite
Shows a list of commands or help for one command

OPTIONS

Goss log verbosity level (default: "INFO") [$GOSS_LOGLEVEL]
Goss file to read from / write to (default: "./goss.yaml") [$GOSS_FILE]
json/yaml file containing variables for template [$GOSS_VARS]
json/yaml string containing variables for template (overwrites vars) [$GOSS_VARS_INLINE]
Package type to use [apk, dpkg, pacman, rpm]
show help

August 2025 goss 0.4.9