From 0608fe4823902ece08a0d24f12f4e46290bd5830 Mon Sep 17 00:00:00 2001 From: Matthew Hooker Date: Wed, 11 Oct 2017 23:12:31 -0700 Subject: [PATCH] mention that winrm can transfer files slowly. --- website/source/docs/provisioners/file.html.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/website/source/docs/provisioners/file.html.md b/website/source/docs/provisioners/file.html.md index ea938f227..da78d4b61 100644 --- a/website/source/docs/provisioners/file.html.md +++ b/website/source/docs/provisioners/file.html.md @@ -114,3 +114,15 @@ lrwxr-xr-x 1 mwhooker staff 5 Jan 27 17:10 file1link -> file1 ] } ``` + +## Slowness when transferring large files over WinRM. + +Because of the way our WinRM transfers works, it can take a very long time to +upload and download even moderately sized files. If you're experiencing +slowness using the file provisioner on Windows, it's suggested that you set up +an SSH server and use the [ssh +communicator](/docs/templates/communicator.html#ssh-communicator). If you only +want to transfer files to your guest, and if your builder supports it, you may +also use the `http_directory` directive. This will cause that directory to be +available to the guest over http, and set the environment variable +`PACKER_HTTP_ADDR` to the address.