2013-06-11 14:24:33 -04:00
|
|
|
---
|
2017-06-14 21:04:16 -04:00
|
|
|
description: |
|
|
|
|
There are a few configuration settings that affect Packer globally by
|
|
|
|
configuring the core of Packer. These settings all have reasonable defaults,
|
|
|
|
so you generally don't have to worry about it until you want to tweak a
|
|
|
|
configuration.
|
2015-07-22 22:31:00 -04:00
|
|
|
layout: docs
|
2017-06-14 21:04:16 -04:00
|
|
|
page_title: 'Core Configuration - Other'
|
|
|
|
sidebar_current: 'docs-other-core-configuration'
|
2017-03-25 18:13:52 -04:00
|
|
|
---
|
2013-06-11 14:24:33 -04:00
|
|
|
|
|
|
|
# Core Configuration
|
|
|
|
|
|
|
|
There are a few configuration settings that affect Packer globally by
|
2013-06-11 14:27:49 -04:00
|
|
|
configuring the core of Packer. These settings all have reasonable defaults, so
|
2015-07-22 22:31:00 -04:00
|
|
|
you generally don't have to worry about it until you want to tweak a
|
|
|
|
configuration. If you're just getting started with Packer, don't worry about
|
|
|
|
core configuration for now.
|
2013-06-11 14:24:33 -04:00
|
|
|
|
2015-07-22 22:31:00 -04:00
|
|
|
The default location where Packer looks for this file depends on the platform.
|
|
|
|
For all non-Windows platforms, Packer looks for `$HOME/.packerconfig`. For
|
|
|
|
Windows, Packer looks for `%APPDATA%/packer.config`. If the file doesn't exist,
|
|
|
|
then Packer ignores it and just uses the default configuration.
|
2013-06-11 14:24:33 -04:00
|
|
|
|
2015-07-22 22:31:00 -04:00
|
|
|
The location of the core configuration file can be modified by setting the
|
|
|
|
`PACKER_CONFIG` environmental variable to be the path to another file.
|
2013-06-11 14:24:33 -04:00
|
|
|
|
2013-06-18 01:30:37 -04:00
|
|
|
The format of the configuration file is basic JSON.
|
|
|
|
|
2013-06-11 14:24:33 -04:00
|
|
|
## Configuration Reference
|
|
|
|
|
|
|
|
Below is the list of all available configuration parameters for the core
|
|
|
|
configuration file. None of these are required, since all have sane defaults.
|
|
|
|
|
2017-10-16 14:23:33 -04:00
|
|
|
- `plugin_min_port` and `plugin_max_port` (number) - These are the minimum and
|
2017-06-14 21:04:16 -04:00
|
|
|
maximum ports that Packer uses for communication with plugins, since plugin
|
|
|
|
communication happens over TCP connections on your local host. By default
|
|
|
|
these are 10,000 and 25,000, respectively. Be sure to set a fairly wide range
|
|
|
|
here, since Packer can easily use over 25 ports on a single run.
|
2015-07-22 23:25:58 -04:00
|
|
|
|
2017-06-14 21:04:16 -04:00
|
|
|
- `builders`, `commands`, `post-processors`, and `provisioners` are objects that
|
|
|
|
are used to install plugins. The details of how exactly these are set is
|
|
|
|
covered in more detail in the [installing plugins documentation
|
|
|
|
page](/docs/extending/plugins.html).
|