To ease installation, it is suggested you install and run with Vagrant. However, if you do not wish to use Vagrant (Disk Space or Stubbornness), the Vagrant configuration in no way inhibits you from doing so.
Vagrant is a portable environment that removes the hassle of aligning your local environment with the needs of the application. This will normally allow you to get started with development extremely fast. This is also ideal if you work on multiple projects, as tweaking your environment for one application while often result in another breaking. Vagrant is cross-platform, so Blinken can be ran effortlessly on Windows, Mac and Linux.
- Checkout blinken
git checkout https://github.com/ideafablabs/blinken.git - Provision Vagrant
vagrant up --provision(this only needs to be ran once) - Follow any prompts
- SSH into Vagrant
vagrant ssh - Move to the active directory
cd /vagrant/app - Start the application
node index.js
- Stopping Vagrant -
vagrant halt - Starting Vagrant -
vagrant up - SSH to box -
vagrant ssh - Destroy/Remove Box -
vagrant destroy
- Install Node
curl -sL https://deb.nodesource.com/setup_4.x | sudo -E bash -
sudo apt-get install -y nodejs
- Install Modules
sudo npm install
If you are or have developed with node on your system in the past, it's very likely you'll encounter some issues. Blinken relies on specific versioning due to specific and fringe dependencies. While having multiple node.js versions on your system is possible, it's tricky, and will likely cause you headaches. You may want to just use Vagrant.
- Check your node version and ensure it is 4.x
node -v - Check your global node modules, and compare these with modules in
package.json - Check your NPM version.
See readme in /app directory for information on how to use and configure Blinken. https://github.com/ideafablabs/blinken/blob/master/app/README.md