Install and Get Started

Table of Contents


The General Installation instructions provide the detailed steps for installing CFEngine, which are generally the same steps to follow for CFEngine Enterprise, with the exception of license keys (if applicable), and also some aspects of post-installation and configuration.

Installing Enterprise Licenses

Before you begin, you should have your license key, unless you only plan to use the free 25 node license. The installation instructions will be provided with the key.

Post-Install Configuration

Change Email Setup After CFEngine Enterprise Installation

For Enterprise 3.6 local mail relay is used, and it is assumed the server has a proper mail setup.

The default FROM email for all emails sent from the Mission Portal is This can be changed on the CFE Server in /var/cfengine/httpd/htdocs/application/config/appsettings.php:$config['appemail'].

Version your policies

Consider enabling the built-in version control of your policies as described in Version Control and Configuration Policy

Whether you do or not, please put your policies in some kind of backed-up VCS. Losing work because of "fat fingering" rm commands is very, very depressing.

Configure collection for monitoring data

Measurements allows you to sample a metric and assess its value across your hosts over time. Collection of monitoring information is disabled by default. Metrics must match monitoring_include in the appropriate report_data_select body. The Masterfiles Policy Framework uses body report_data_select default_data_select_policy_hub to specify metrics that should be collected from policy hubs and default_data_select_host to specify metrics that should be collected from non hubs. Augments can be used to configure which metrics should be collected for central reporting.

Review settings

See the Masterfiles Policy Framework for a full list of all the settings you can configure.