---
name: "puppet-script"
section: "8"
platform: "linux"
package: "openvox"
version: "8.28.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/puppet-script"
---

# puppet-script(8)

Run a puppet manifests as a script without compiling a catalog

## NAME

**puppet-script** - Run a puppet manifests as a script without compiling a catalog

## SYNOPSIS

Runs a puppet language script without compiling a catalog.

## USAGE

puppet script \[-h\|--help\] \[-V\|--version\] \[-d\|--debug\] \[-v\|--verbose\] \[-e\|--execute\] \[-l\|--logdest syslog\|eventlog\|*FILE*\|console\] \[--noop\] *file*

## DESCRIPTION

This is a standalone puppet script runner tool; use it to run puppet code without compiling a catalog.

When provided with a modulepath, via command line or config file, puppet script can load functions, types, tasks and plans from modules.

## OPTIONS

Note that any setting that's valid in the configuration file is also a valid long argument. For example, 'environment' is a valid setting, so you can specify '--environment mytest' as an argument.

See the configuration file documentation at https://puppet.com/docs/puppet/latest/configuration.html for the full list of acceptable parameters. A commented list of all configuration options can also be generated by running puppet with '--genconfig'.

- \--debug

  Enable full debugging.

- \--help

  Print this help message

- \--logdest

  Where to send log messages. Choose between 'syslog' (the POSIX syslog service), 'eventlog' (the Windows Event Log), 'console', or the path to a log file. Defaults to 'console'. Multiple destinations can be set using a comma separated list (eg: **/path/file1,console,/path/file2**)"

-

  A path ending with '.json' will receive structured output in JSON format. The log file will not have an ending '\]' automatically written to it due to the appending nature of logging. It must be appended manually to make the content valid JSON.

-

  A path ending with '.jsonl' will receive structured output in JSON Lines format.

- \--noop

  Use 'noop' mode where Puppet runs in a no-op or dry-run mode. This is useful for seeing what changes Puppet will make without actually executing the changes. Applies to tasks only.

- \--execute

  Execute a specific piece of Puppet code

- \--verbose

  Print extra information.

## EXAMPLE

```
$ puppet script -l /tmp/manifest.log manifest.pp
$ puppet script --modulepath=/root/dev/modules -e 'notice("hello world")'
```

## AUTHOR

Henrik Lindberg

## COPYRIGHT

Copyright (c) 2017 Puppet Inc. Copyright (c) 2024 Vox Pupuli Licensed under the Apache 2.0 License