Windows Installation Guide

These instructions were updated and tested on Windows 10 x64 as of 4/6/2017

The new Windows curator updates seems to have changed how the native Windows environment variables interact with BASH commands, the process below might differ if you have updated to the Windows 10 CU

Please read through the instructions before you start! I don't want you to miss any steps.

If you have any problems please submit an issue HERE!

1. Install Cygwin for your platform (x86_64 most likely) http://www.cygwin.com/
   (http://www.cygwin.com/setup-x86_64.exe)

   Previous installations of cygwin might affect this step. If you have issues you might consider rebooting.

2. Install nodejs (You'll want the x64.msi) https://nodejs.org/en/download/ (https://nodejs.org/dist/v6.10.2/node-v6.10.2-x64.msi)

3. Download and install RailsInstaller https://s3.amazonaws.com/railsinstaller/Windows/railsinstaller-3.3.0.exe

4. Configure git once the installer finishes using the new command prompt window.

5. Close and re-open "Command Prompt with Ruby on Rails" with administrator privileges. (Right-click on the application and hit "Run as administrator"). You should be at C:\Sites

6. git clone https://github.com/scytherswings/Plex-Board.git

7. cd C:\Sites\Plex-Board

8. gem install bundler

9. bash serverSetup.sh

10. Edit server_config.yml to use a valid IP on the machine. You can see the available IP addresses from ipconfig. This file was located under C:\Sites\Plex-Board\server_config.yml If you change relative_root then you will need to run serverSetup.sh again so that the generated assets match the expected paths.

11. bash startServer.sh To start the server!

Note that if you kill the server with Ctrl+C it seems to leave behind a process. You'll need to kill ruby in the Task Manager if you want to be able to restart the process. I will figure out a fix for this soon. Perhaps in the form of a restart script.

Debugging

• Make sure you have nodejs installed and it is usable. You can check this with node -v if that returns a version then you are good. If not, and you know nodejs is installed, then try rebooting.

  If you see serverSetup.sh barf with an error like:

  rake aborted!
  TypeError: Object doesn't support this property or method
  

  Or:

  ActionView::Template::Error (Current ExecJS runtime does't support ES5. Please install node.js.):
  

  That means you don't have nodejs installed. If you installed it already then do a reboot.

• If you see a file permissions error for loading an image you might need to change the Plex-Board/public/images folder to have permissions to be accessible by everyone.