Skip to content
This repository


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Collect and display system facts

Octocat-spinner-32 acceptance (FACT-375) Fix json gem installation on solaris April 10, 2014
Octocat-spinner-32 bin (#15586) Use OptionParser for help August 20, 2013
Octocat-spinner-32 ext debian/control: Recommend lsb-release. April 09, 2014
Octocat-spinner-32 lib Merge branch 'facter-2' April 10, 2014
Octocat-spinner-32 libexec (#2157) add readme for libexec external facts June 15, 2012
Octocat-spinner-32 man (FACT-272) Update manpage based on facter --help February 24, 2014
Octocat-spinner-32 schema Merge branch 'facter-2' February 27, 2014
Octocat-spinner-32 spec Merge branch 'facter-2' April 10, 2014
Octocat-spinner-32 tasks Merge branch 'facter-2' April 10, 2014
Octocat-spinner-32 .autotest (#6610) Fix Autotest proper run September 06, 2011
Octocat-spinner-32 .gemspec Merge branch 'stable' April 22, 2013
Octocat-spinner-32 .gitignore (#22233) Add facts from Google Compute Engine metadata service August 20, 2013
Octocat-spinner-32 .mailmap (maint) Add mailmap for git shortlog October 18, 2012
Octocat-spinner-32 .noexec.yaml (#15464) Make contributing easy via bundle Gemfile August 16, 2012
Octocat-spinner-32 .travis.yml Merge branch 'facter-2' March 12, 2014
Octocat-spinner-32 .yardopts Document Facter API with YARD December 20, 2013
Octocat-spinner-32 (maint) Update docs to reflect use of facter-2 branch February 16, 2014
Octocat-spinner-32 (maint) Update docs to reflect use of facter-2 branch February 16, 2014
Octocat-spinner-32 Gemfile (maint) Pin rake to the last 1.8 compatible version March 24, 2014
Octocat-spinner-32 LICENSE Update copyright years in LICENSE September 11, 2012
Octocat-spinner-32 (#22857) Note that ruby 2.0.0 should be at least p195. October 29, 2013
Octocat-spinner-32 Rakefile Merge branch 'facter-2' February 14, 2014
Octocat-spinner-32 install.rb (FACT-321) Remove ENV['DESTDIR'] and --test from install.rb February 10, 2014


Build Status

This package is largely meant to be a library for collecting facts about your system. These facts are mostly strings (i.e., not numbers), and are things like the output of uname, public ssh keys, the number of processors, etc.

See bin/facter for an example of the interface.


Generally, you need the following things installed:

  • A supported Ruby version. Ruby 1.8.7, 1.9.3, and 2.0.0 (at least p195) are fully supported.

Running Facter

Run the facter binary on the command for a full list of facts supported on your host.

Adding your own facts

See the Adding Facts page for details of how to add your own custom facts to Facter.

Running Specs

  • bundle install --path .bundle/gems
  • bundle exec rake spec

Note: external facts in the system facts.d directory can cause spec failures.

Further Information

See for more details.

Something went wrong with that request. Please try again.