packer/website/source/docs/builders/null.html.markdown

---
description: |
    The `null` Packer builder is not really a builder, it just sets up an SSH
    connection and runs the provisioners. It can be used to debug provisioners
    without incurring high wait times. It does not create any kind of image or
    artifact.
layout: docs
page_title: Null Builder
...

# Null Builder

Type: `null`

The `null` Packer builder is not really a builder, it just sets up an SSH
connection and runs the provisioners. It can be used to debug provisioners
without incurring high wait times. It does not create any kind of image or
artifact.

## Basic Example

Below is a fully functioning example. It doesn't do anything useful, since no
provisioners are defined, but it will connect to the specified host via ssh.

``` {.javascript}
{
  "type":         "null",
  "ssh_host":     "127.0.0.1",
  "ssh_username": "foo",
  "ssh_password": "bar"
}
```

## Configuration Reference

The null builder has no configuration parameters other than the
[communicator](/docs/templates/communicator.html) settings.