cfengine  3.18.0
About: CFEngine is a configuration management system for configuring and maintaining Unix-like computers (using an own high level policy language). Community version. Community version. LTS (Long Term Support) release.
  Fossies Dox: cfengine-3.18.0.tar.gz  ("unofficial" and yet experimental doxygen-generated source code documentation)  

cfengine Documentation

Some Fossies usage hints in advance:

  1. To see the Doxygen generated documentation please click on one of the items in the steelblue colored "quick index" bar above or use the side panel at the left which displays a hierarchical tree-like index structure and is adjustable in width.
  2. If you want to search for something by keyword rather than browse for it you can use the client side search facility (using Javascript and DHTML) that provides live searching, i.e. the search results are presented and adapted as you type in the Search input field at the top right.
  3. Doxygen doesn't incorporate all member files but just a definable subset (basically the main project source code files that are written in a supported language). So to search and browse all member files you may visit the Fossies cfengine-3.18.0.tar.gz contents page and use the Fossies standard member browsing features (also with source code highlighting and additionally with optional code folding).

Gitter chat

Version Core MPF
master Core Build Status MPF Build Status
3.15.x LTS Core Build Status MPF Build Status
3.12.x LTS Core Build Status MPF Build Status

Language grade: C

CFEngine 3

CFEngine 3 is a popular open source configuration management system. Its primary function is to provide automated configuration and maintenance of large-scale computer systems.

Source code repositories

CFEngine is comprised of several source code repositories. As you might be looking for another part of the open source code base, here is a list to ease navigation:

  • core (This repo) - The C source code for core components, like cf-agent and cf-serverd.
    • libntech (submodule in core) - Library of reusable C code, such as data structures, string manipulation, JSON parsing, file handling, etc.
    • core/contrib (subdirectory in core) - User-contributed tools and scripts
  • masterfiles - The Masterfiles Policy Framework (MPF) contains the default policy (.cf) files
  • documentation - Documentation on how CFEngine components work, the policy language, the enterprise features, etc.
  • cf-remote - Tooling to make deploying / testing CFEngine across many remote instances easy
  • buildscripts - Scripts and files needed to build installer packages across a wide variety of supported platforms

(Each repo also contains some supporting code/files, such as tests, scripts, documentation, etc.).


Pre-built installers are available from our website:

To install from source please see the INSTALL file for prerequisites and build instructions.


As per the LICENSE file, CFEngine Community is licensed under the GNU General Public License, version 3.

All the files in this repository are licensed under GNU GPL version 3, unless stated otherwise in the copyright notice inside the particular file.

Example Usage

Hello World

The following code demonstrates simple CFEngine output through a reports promise.

body common control
  bundlesequence => { "run" };

bundle agent run
      "Hello, world";

The following policy code may be executed with cf-agent (the main CFEngine binary) as follows.

$ cf-agent/cf-agent
R: Hello, world


Please see the file.

Relationship to CFEngine 2

CFEngine 3 is not a drop-in upgrade for CFEngine 2 installations. It is a significantly more powerful version, but it is incompatible with the CFEngine 2 policy language.

The server part of CFEngine 3 supports the network protocol of CFEngine 2, so you may upgrade your installation gradually.


CFEngine was originally created by Mark Burgess with many contributions from around the world. Thanks everyone!

CFEngine is sponsored by AS