These instructions will create a Vagrant virtual machine ready for Sails.js development. This allows developers to begin writing code without worrying about how to install or configure Node.js or Sails.js.
Check out the explanation in the Sail.js Github repository.
- Download and install VirtualBox 4.3.20
- Download and install Vagrant 1.7.1 or better
- Download Git for Windows:
- Run the installer and "next" through the wizard until the step to adjust your PATH environment.
- Choose the third option, "Run Git and included tools from within the Windows Command prompt"
- Important: On the next step, "Configuring the line ending conversions", choose the second option: "Checkout as-is, commit Unix-style line endings".
- Choose "next" through any additional steps to complete the Git for Windows install.
- Open the Windows Command Prompt as Administrator
Fork the sails-vagrant
repository on Github.
Clone your fork of the sails-vagrant
repository to a directory on your host machine:
git clone --recursive https://github.com/<github-username>/sails-vagrant.git
Change directory to your sails-vagrant
directory:
cd sails-vagrant
Once you cd
into the sails-vagrant directory, you will find a "Vagrantfile" which will provide
the necessary instructions and provisioning to setup your development virtual machine. All Vagrant commands
should be performed in this directory with your Vagrantfile.
Start the virtual machine:
vagrant up
Connect to the virtual machine via ssh:
vagrant ssh
- You will find a
dev
folder in thehome/vagrant
directory that will sync all of its contents to adev
folder adjacent to your Vagrantfile on your host machine. This allows for editing code on your host machine and having it immediately available inside of the virtual machine.
Change directory to development:
cd dev
Create a new app:
sails new testProject
Now lift the server:
cd testProject
sails lift
If you visit (http://localhost:1337/) you will see the default home page. Vagrant will automatically port-forward localhost:1337 to localhost:1337 on your guest virtual machine.