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

---
layout: "docs"
page_title: "Null Builder"
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.
---

# 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.