Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Collect and display system facts
Failed to load latest commit information.
acceptance (FACT-826) Use /opt/puppetlabs/facter/facts.d
bin (FACT-480) Remove current directory from Ruby load path.
documentation (FACT-472) Sync facter-2 branch to master
etc (FACT-472) Sync facter-2 branch to master
ext (PUP-3479) Update ffi to ~1.9.5
lib (FACT-826) Use /opt/puppetlabs/facter/facts.d
libexec/ext (#2157) add readme for libexec external facts
man/man8 (FACT-272) Update manpage based on facter --help
schema Merge branch 'stable'
spec (FACT-826) Use /opt/puppetlabs/facter/facts.d
tasks (FACT-472) Sync facter-2 branch to master
.autotest (#6610) Fix Autotest proper run
.editorconfig (maint) support consistent coding style across users
.gemspec (FACT-472) Sync facter-2 branch to master
.gitignore (maint) ignore .idea folder
.mailmap (maint) Add mailmap for git shortlog
.noexec.yaml (#15464) Make contributing easy via bundle Gemfile
.rspec (FACT-472) Sync facter-2 branch to master
.travis.yml (maint) Add ruby 2.1.5 to the travis matrix
.yardopts Document Facter API with YARD Revert "(maint) Update docs to reflect use of facter-2 branch" (doc) facter.json schema
Gemfile (maint) add yarjuf to Gemfile
LICENSE (maint) Update copyright year in LICENSE (FACT-653) Doc update for supported Ruby Version cherry-pick
Rakefile (FACT-472) Sync facter-2 branch to master
install.rb (FACT-321) Remove ENV['DESTDIR'] and --test from install.rb


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.


Please log tickets and issues at our JIRA tracker. A mailing list is available for asking questions and getting help from others. In addition there is an active #puppet channel on Freenode.

We use semantic version numbers for our releases, and recommend that users stay as up-to-date as possible by upgrading to patch releases and minor releases as they become available.

Bugfixes and ongoing development will occur in minor releases for the current major version. Security fixes will be backported to a previous major version on a best-effort basis, until the previous major version is no longer maintained.

For example: If a security vulnerability is discovered in Facter 2.1.0, we would fix it in the 2 series, most likely as 2.1.1. Maintainers would then make a best effort to backport that fix onto the latest Facter 1.7 release.

Long-term support, including security patches and bug fixes, is available for commercial customers. Please see the following page for more details:

Puppet Enterprise Support Lifecycle

Something went wrong with that request. Please try again.