2014-01-11 02:15:49 +00:00
|
|
|
---
|
|
|
|
|
page_title: "RSync - Synced Folders"
|
|
|
|
|
sidebar_current: "syncedfolder-rsync"
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
# RSync
|
|
|
|
|
|
|
|
|
|
**Synced folder type:** `rsync`
|
|
|
|
|
|
|
|
|
|
Vagrant can use [rsync](http://en.wikipedia.org/wiki/Rsync) as a mechanism
|
|
|
|
|
to sync a folder to the guest machine. This synced folder type is useful
|
|
|
|
|
primarily in situations where other synced folder mechanisms are not available,
|
|
|
|
|
such as when NFS or VirtualBox shared folders aren't available in the guest
|
|
|
|
|
machine.
|
|
|
|
|
|
|
|
|
|
The rsync synced folder does a one-time one-way sync from the machine running
|
|
|
|
|
to the machine being started by Vagrant.
|
|
|
|
|
|
2014-01-14 17:34:21 +00:00
|
|
|
The [rsync](/v2/cli/rsync.html) and [rsync-auto](/v2/cli/rsync-auto.html)
|
|
|
|
|
commands can be used to force a resync and to automatically resync when
|
|
|
|
|
changes occur in the filesystem. Without running these commands, Vagrant
|
|
|
|
|
only syncs the folders on `vagrant up` or `vagrant reload`.
|
|
|
|
|
|
2014-01-11 02:15:49 +00:00
|
|
|
## Prerequisites
|
|
|
|
|
|
|
|
|
|
To use the rsync synced folder type, the machine running Vagrant must have
|
|
|
|
|
`rsync` (or `rsync.exe`) on the path. This executable is expected to behave
|
|
|
|
|
like the standard rsync tool.
|
|
|
|
|
|
2014-01-16 05:35:43 +00:00
|
|
|
On Windows, rsync installed with Cygwin or MinGW will be detected by
|
|
|
|
|
Vagrant and works well.
|
|
|
|
|
|
2014-02-03 11:14:41 +00:00
|
|
|
The destination machine must also have rsync installed, but Vagrant
|
|
|
|
|
can automatically install rsync into many operating systems. If Vagrant
|
|
|
|
|
is unable to automatically install rsync for your operating system,
|
|
|
|
|
it will tell you.
|
|
|
|
|
|
2014-01-11 02:15:49 +00:00
|
|
|
## Options
|
|
|
|
|
|
|
|
|
|
The rsync synced folder type accepts the following options:
|
|
|
|
|
|
2014-03-13 01:35:57 +00:00
|
|
|
* `rsync__args` (array of strings) - A list of arguments to supply
|
|
|
|
|
to `rsync`. By default this is `["--verbose", "--archive", "--delete", "-z"]`.
|
2014-03-06 19:27:58 +00:00
|
|
|
|
2014-03-06 20:18:13 +00:00
|
|
|
* `rsync__auto` (boolean) - If false, then `rsync-auto` will not
|
|
|
|
|
watch and automatically sync this folder. By default, this is true.
|
|
|
|
|
|
2014-05-17 19:01:50 +00:00
|
|
|
* `rsync__chown` (boolean) - If false, then the `owner` and `group`
|
|
|
|
|
options for the synced folder are ignored and Vagrant won't execute
|
|
|
|
|
a recursive `chown`. This defaults to true. This option exists because
|
|
|
|
|
the `chown` causes issues for some development environments.
|
|
|
|
|
|
2014-01-11 02:15:49 +00:00
|
|
|
* `rsync__exclude` (string or array of strings) - A list of files or directories
|
|
|
|
|
to exclude from the sync. The values can be any acceptable rsync exclude
|
|
|
|
|
pattern. By default, the ".vagrant/" directory is excluded. We recommend
|
|
|
|
|
excluding revision control directories such as ".git/" as well.
|
|
|
|
|
|
|
|
|
|
## Example
|
|
|
|
|
|
|
|
|
|
The following is an example of using RSync to sync a folder:
|
|
|
|
|
|
|
|
|
|
<pre class="prettyprint">
|
|
|
|
|
Vagrant.configure("2") do |config|
|
|
|
|
|
config.vm.synced_folder ".", "/vagrant", type: "rsync",
|
|
|
|
|
rsync__exclude: ".git/"
|
|
|
|
|
end
|
|
|
|
|
</pre>
|
