stennie / keystone-vagrant

An Ubuntu 14.04 Vagrant box ready to get started with KeystoneJS (Node.js, MongoDB, Yeoman, Heroku toolbelt)

Ubuntu 14.04 64-bit Vagrant Box for KeystoneJS

What is this for?

This box recipe provides a quick start to trying out the KeystoneJS content management system using a Vagrant 1.1+ development environment.

After successful installation you will have:

• Ubuntu 14.04 64-bit VM listening on 192.168.192.168
• Current version of Node.js (software platform that powers Keystone)
• Current version of MongoDB (NoSQL document-oriented database)
• All npm dependencies for KeystoneJS including Mongoose and Express.
• Current version of the Keystone Yeoman generator (aka 'yo keystone')
• Heroku Toolbelt for deployment

If you would prefer to install the Keystone Generator manually, you can instead follow the documentation on the generator-keystone page on npmjs.org.

How do you use this box?

1. Download and install VirtualBox (tested with 4.3.6)
2. Download and install Vagrant - 1.1 or newer required (tested with 1.4.3)
3. Clone this repository
4. cd keystone-vagrant/
5. vagrant up
6. Grab a cup of coffee while you wait for the server to download and install. This will take a little while depending on your internet connection.
7. Once done vagrant ssh and in that folder run yo keystone.
8. Answer all of the setup questions and then acces your brand new keystone site at 192.168.192.168:3000. Login with the default user: [email protected], pw: admin.

Further Reading

• Vagrant Documentation
• Node.js
• MongoDB
• KeystoneJS

Credits

• Based on node-mongo-vagrant (thanks @markdunphy!)
• Created for the Sydney MongoDB User Group meetup on 25th Feb, 2014.