goss

goss Plugin

Quick and Easy server testing. Define infrastructure expectations as YAML and run them in milliseconds — ideal for CI, Docker image validation, and post-deploy smoke tests.

Installation

curl -fsSL https://goss.rocks/install | sh
# or
brew install goss

Basic Usage

# Auto-generate tests from current system state
goss add package nginx
goss add port 80
goss add file /etc/nginx/nginx.conf

# Run validation
goss validate

# Validate a Docker image
dgoss run myimage:latest /goss/goss validate

Common Patterns

# Write tests to goss.yaml
goss add service ssh --port 22

# Validate with formatted output
goss validate --format documentation

# Validate against a remote host
goss validate --endpoint tcp://myserver:22

Usage Examples

• "Check that nginx is installed and port 80 is listening"
• "Validate this Docker image has the right packages"
• "Generate goss tests from the current server state"

SuperCLI

sc goss _ _ validate
sc goss _ _ add port 8080
sc plugins learn goss