Symbolic links and synced folders in Vagrant
Solution 1:
The accepted answer is no good. The question describes an issue with synced folders, not shared folders. The proposed solution would have no effect on an rsynced (not shared) folder. And even if the OP was using a shared folder, the accepted answer's suggestion is something that had already been integrated into vagrant as of 1.1, released 15 months before the OP posted the question (not to mention VirtualBox's shared folders are abysmally slow).
I encountered this same issue: on OS X, I got the symlink has no referent
rsync error. I was personally able to solve it by adding particular rsync args to my vagrantfile
:
config.vm.synced_folder ".", "/var/www", type: "rsync", rsync__args: ["--verbose", "--archive", "--delete", "-z"]
I also opened this issue on vagrant's github to point out something that appears to be wrong with their default value for rsync__args
(specifically, that one of the default args, --copy-links
, seems to be breaking another, --archive
, at least as far as copying broken symlinks is concerned).
Solution 2:
Virtualbox does not allow symlinks on shared folders for security reasons. To enable symlinks the following line needs to be added to the vm provider config block in the Vagrantfile:
config.vm.provider "virtualbox" do |v|
v.customize ["setextradata", :id, "VBoxInternal2/SharedFoldersEnableSymlinksCreate/v-root", "1"]
end
Additionally, on windows vagrant up needs to be executed in a shell with admin rights. No workarounds necessary.
Solution 3:
I tried all these options in order to resolve an error running npm install
.
Simply running vagrant in an admin prompt and loading the vm (vagrant reload
), resolved the issue.
I went back and removed the SharedFoldersEnableSymlinksCreate
configuration from the Vagrantfile, and everything was still fine.
Solution 4:
The default synced folder type is vboxsf
has known performance issue with large number of files / directories, and lacks support for symbolic links and hard links (see ticket 818 - a 7+ year old bug). Avoid using it.
rsync type synced folder may be your best choice.
You mentioned that it crashed, what version of rsync are you running? Try to update it to 3.1.0 via brew, I know the OOTB one is way too old (2.x), which could be causing issues.