Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

Serverspec

serverspec.org

  • Free plan
  • Windows
  • macOS
  • Linux
  • Self-hosted
7.2 Club score Visit serverspec.org

What Serverspec is

Serverspec is an open-source Ruby tool for writing RSpec tests that check whether servers are configured correctly. It examines actual server state by running commands locally or through SSH, WinRM, or the Docker API, without requiring agent software on target servers. Documented checks include packages, services, files, ports, users, Docker containers and images, Windows features, and X.509 certificates and private keys. Serverspec works with both RSpec `should` and `expect` syntax and can be used alongside tools such as Puppet, Ansible, CFEngine, Itamae, and Chef. Its stated aim is helping teams refactor infrastructure code. The tutorial names a broad set of operating systems, but notes that not all are fully supported. Each test suite is intended for one machine or Docker container, with a separate RSpec command for each target. Install the `serverspec` gem with Bundler or `gem install serverspec`. The project is maintained by Gosuke Miyashita and is MIT licensed; its listed latest release is v2.43.0, dated April 24, 2025.

Who it suits

Serverspec suits teams checking server configuration or refactoring infrastructure code, especially those already using RSpec and configuration tools such as Puppet or Ansible. It covers multiple operating systems, though the tutorial notes that support is not complete for all of them.

Good to know, and what to watch

  • Checks actual state without target-server agents
  • Supports SSH, WinRM, and Docker API checks
  • Documents checks for files, services, users, and more
  • Works with both RSpec `should` and `expect` syntax
  • Free, open-source, and MIT licensed
  • Each test suite targets one machine or container
  • Some listed operating systems are not fully supported
  • GitHub issues are disabled

Serverspec

Free

Open source

The verdict

Serverspec provides agentless RSpec checks for a wide range of server resources and can work alongside several configuration tools. Its one-target-per-suite model and incomplete support for some listed systems are worth factoring into setup.

What the maker publishes

Agentless
The site says Serverspec does not require agent software to be installed on target servers. source
Configuration tools
The site names Puppet, Ansible, CFEngine, and Itamae as configuration management tools it can be used with. source
Execution scope
The site says a test suite is meant for one machine or Docker container and advises running a separate RSpec command for each target. source
How it checks
It checks servers’ actual state by executing commands locally or through SSH, WinRM, and Docker API, among other methods. source
Infrastructure code
The site describes helping refactor infrastructure code as Serverspec’s true aim. source
Installation
The site documents installing the `serverspec` Ruby gem with Bundler or `gem install serverspec`. source
License and latest release
GitHub identifies the repository as MIT licensed and lists v2.43.0 as its latest release, dated April 24, 2025. source
Maintenance
The project’s GitHub README says it accepts pull requests and disables issues. source
Maker
The official site says the project is maintained by Gosuke Miyashita. source
Operating systems
The tutorial lists AIX, Arch Linux, macOS, Debian, Fedora/Red Hat/CentOS, FreeBSD, Gentoo Linux, NixOS, OpenBSD, openSUSE, Plamo Linux, SmartOS, Solaris, SUSE, Ubuntu, and Windows, while noting that not all are fully supported. source
Purpose
Serverspec lets users write RSpec tests to check that servers are configured correctly. source
Resource checks
Documented resource types include packages, services, files, ports, users, Docker containers and images, Windows features, and X.509 certificates and private keys. source
Test syntax
Serverspec works with both RSpec `should` and `expect` syntax. source

Checked against the maker's pages on 7 Oct 2026.