Installation fails

Check for these issues if Puppet agent installation fails on a Windows node.

The installation package isn't accessible

The source of an .msi or .exe package must be a file on either:

  • A local filesystem
  • A network mapped drive
  • A UNC path

RI-based installation sources aren't supported, but you can achieve a similar result by defining a file whose source is the primary server, and then defining a package whose source is the local file.

Installation wasn't attempted with admin privileges

Installing thePuppet agent requires elevated privileges, such as being logged in as the Administrator or running commands in an Administrator command prompt or PowerShell window.

The following are indications that you are attempting to install without admin privileges:

  • Agent installation fails when trying to perform an unattended installation from the command line.
  • You get a norestart message.
  • The installation logs indicate that installation is forbidden by system policy.