Standalone PE-PostgreSQL Installation

This version is out of date. For current versions, see Puppet Enterprise support lifecycle.

In a default PE installation, PE-PostgreSQL (the database backend for PE ) is installed alongside PuppetDB. If needed, you can install a separate, standalone instance of PE-PostgreSQL.

Before you begin, please read the following:

To install a standalone PE-PostgreSQL node, you’ll need root access to the node, and you’ll need the ability to SSH and copy files over to it.

NOTE: If you do not have root access, or you want to use a dedicated database as a service tool, such as Amazon’s RDS, refer to, Enabling PE and external PostgreSQL without root access

This example is based on a monolithic installation. We’ll refer to the the master of masters (MoM) as and to the PE-PostgreSQL node as

Important: You can only install a standalone PE-PostrgreSQL node using text mode installation.

  1. Refer to the text mode installation instructions for a monolithic PE install.
  2. When editing the pe.conf file for the installation, specify the following parameters:

      "puppet_enterprise::puppet_master_host": ""
      "puppet_enterprise::console_admin_password": "YOUR CONSOLE ADMIN PASSWORD"
      "puppet_enterprise::database_host": ""
  3. Run the installer with the pe.conf file you created.

    sudo ./puppet-enterprise-installer -c <FULL PATH TO pe.conf>

The installer will fail halfway through, as it cannot contact the database, and the PE components that rely on the database (PuppetDB, PE Console) will fail to start. The next installation run will correct this.

  1. Copy the pe.conf you made to the and SSH into that node.
  2. Run the installer with the same pe.conf.

sudo ./puppet-enterprise-installer -c <FULL PATH TO pe.conf>

  1. When the installation process completes on the node, SSH back into the node, and run the following commands to complete the installation:

puppet infrastructure configure; puppet agent -t;

After these Puppet runs, the MoM is configured to use the standalone PE-PostgreSQL installation on

Puppet sites use proprietary and third-party cookies. By using our sites, you agree to our cookie policy.