# MusareNode Musare in NodeJS, Express, SocketIO and VueJS. ## Requirements * [Virtualbox](https://www.virtualbox.org/) * [Vagrant](https://www.vagrantup.com/) ##### Important Notes The latest version of Vagrant (1.8.5) has some issues with inserting ssh keys into the machine. It's a show stopping bug that they aren't going to fix until the [next release](https://github.com/mitchellh/vagrant/issues/7610#issuecomment-234609660). So for now, I recommend using [Vagrant 1.8.4](https://releases.hashicorp.com/vagrant/1.8.4/). You'll also need to use a slightly [older version of Virtualbox](https://www.virtualbox.org/wiki/Download_Old_Builds_5_0) because of this. ## Getting Started Once you've installed the required tools: 1. `git clone https://github.com/MusareNode/MusareNode.git` 2. `cd MusareNode` 3. `cp backend/config/template.json backend/config/default.json` > The `secret` key can be whatever. It's used by express's session module. The `apis.youtube.key` value can be obtained by setting up a [YouTube API Key](https://developers.google.com/youtube/v3/getting-started). 4. `vagrant up` 5. `vagrant reload` This will ensure that the services we've created start up correctly. Once this is done you should be able to access Musare in your local browser at [172.16.1.2](http://172.16.1.2). To access the RethinkDB admin panel, go to [172.16.1.2:8080](http://172.16.1.2:8080) in your local web browser. You can also now access your machine using: `vagrant ssh` Or if you have [mosh](https://mosh.org/) installed (and have ran `vagrant plugin install vagrant-mosh`), you can run: `vagrant mosh` You can run `vagrant` to view more options. ### Production Logs You can view logs at the following locations: * Musare: `/var/log/upstart/musare.log` * mongoDB: `/var/log/upstart/mongodb.log` ### Development Make sure to `vagrant ssh` from the root of the repo before calling these (make sure your ssh'd into the vagrant machine). ```bash # Start backend server cd /musare; sudo node backend/app.js # Build frontend in development mode cd /musare/frontend; npm run development # Build frontend in production mode cd /musare/frontend; npm run production # Automatically build frontend in development mode when files change cd /musare/frontend; npm run development-watch ``` ### Production (these can also be used in development) Make sure to `vagrant ssh` from the root of the repo before calling these (make sure your ssh'd into the vagrant machine). ```bash # Start the production server sudo service musare start # Start the mongodb sudo service mongodb start ``` ### FAQ ##### What does `vagrant up` do? This will pull down the Ubuntu 14.04 vagrant box and setup a virtualbox machine for you. It'll ask you what network interface you want the virtualbox machine to connect to the internet with. On macOS I typically choose `en0: Wi-Fi (AirPort)`, but it'll be different on different platforms. It will then run the commands in the `bootstrap.sh` file on this virtual machine. This will install nodejs, rethinkdb, and a bunch of other goodies. This same file could be ran on a production Ubuntu 14.04 server with very little modifications (if any at all). ##### What does `vagrant ssh` and `vagrant mosh` do? Vagrant automagically generates and inserts a openssh keypair for you. This doesn't really have any security (as it doesn't really need to be since it's only for development). This allows you to access your machine in a very convenient way. The second command, `vagrant mosh`, is actually just a vagrant plugin. Mosh is a replacement for SSH, and if you haven't checked it out before, you really should! :) ##### Why use Vagrant? I can run NodeJS and mongoDB locally The reason for using vagrant is simple. It gives every developer the same local development server. This removes any inconsistencies across different dev enviroments (Windows vs macOS vs Linux). It also ensures that your changes are running on an environment that exactly matches the production server.