- A GNU/Linux or OS X machine.
- Install VirtualBox (...because)
- Install Vagrant (docs)
- Make sure you have
git
installed on your system.
- Clone the repository:
git clone https://github.com/Trustroots/trustroots.git trustroots && cd trustroots
- Type
bash scripts/vagrant-setup.sh
. - Install will ask for your password to add "trustroots.dev" to your hosts file.
- Open http://trustroots.dev/ in your browser.
You can login with username trout
and password password
.
After setup your virtual machine is running. Suspend the virtual machine by typing vagrant suspend
.
When you're ready to begin working again, just run vagrant up
.
To compile+watch assets, run grunt watch
(or grunt build
to compile once) right after running vagrant up
.
To use http://192.168.33.10/ instead of "trustroots.dev" hostname,
set config.hostmanager.enabled = false
at Vagrant file and change domain also to scripts/vagrantup/nginx_trustroots_dev.conf
.
You can modify your sudoers file
to stop Vagrant asking for password each time.
We're using Phusion open Ubuntu 14.04 basebox.
During the first up scripts/vagrantup/vagrantup.sh
installs these:
- Nginx
- NodeJS
- NPM
- MongoDB
- Phusion Passenger
- Grunt
- Gulp
- Bower
- Yeoman
- Generator-meanjs
vagrant ssh
If for some reason you want to have clean box & database, run:
vagrant destroy && vagrant up
Although not necessary, if you want to check for updates, just type:
vagrant box outdated
It will tell you if you are running the latest version or not of the box. If it says you aren't, simply run:
vagrant box update