vagrant/website/source/intro/getting-started/synced_folders.html.md

2.3 KiB

layout page_title sidebar_current description
intro Synced Folders - Getting Started gettingstarted-syncedfolders While it is cool to have a virtual machine so easily, not many people want to edit files using just plain terminal-based editors over SSH. Luckily with Vagrant you do not have to. By using synced folders, Vagrant will automatically sync your files to and from the guest machine.

Synced Folders

While it is cool to have a virtual machine so easily, not many people want to edit files using just plain terminal-based editors over SSH. Luckily with Vagrant you do not have to. By using synced folders, Vagrant will automatically sync your files to and from the guest machine.

By default, Vagrant shares your project directory (remember, that is the one with the Vagrantfile) to the /vagrant directory in your guest machine.

Note that when you vagrant ssh into your machine, you're in /home/vagrant. /home/vagrant is a different directory from the synced /vagrant directory.

If your terminal displays an error about incompatible guest additions (or no guest additions), you may need to update your box or choose a different box such as hashicorp/bionic64. Some users have also had success with the vagrant-vbguest plugin, but it is not officially supported by the Vagrant core team.

Run vagrant up again and SSH into your machine to see:

$ vagrant up
...
$ vagrant ssh
...
vagrant@bionic64:~$ ls /vagrant
Vagrantfile

Believe it or not, that Vagrantfile you see inside the virtual machine is actually the same Vagrantfile that is on your actual host machine. Go ahead and touch a file to prove it to yourself:

vagrant@bionic64:~$ touch /vagrant/foo
vagrant@bionic64:~$ exit
$ ls
foo Vagrantfile

Whoa! "foo" is now on your host machine. As you can see, Vagrant kept the folders in sync.

With synced folders, you can continue to use your own editor on your host machine and have the files sync into the guest machine.

Next Steps

You have successfully interacted with your host machine via synced folders on the guest machine. Read on to learn about installing packages, users, and more with provisioning.