Install Dashing dashboard on Windows

At our workplace, we have a Jenkins instance handing our Continuous Integration (build, test, code analysis).

I am a big fan of Jenkins, but find the native dashboard capabilities are somewhat lacking. Looking for a better looking dashboard solution, I came across Dashing from Shopify.

Dashing is a great-looking framework which (I hope!) will meet my dashboard needs.

This article runs through the steps to get Dashing up and running on a Windows platform. While the Dashing documentation is straight-forward, there are a number of issues that can trip you up when installing on Windows.

Step 1: Install Ruby

Dashing is built on top of Ruby – you will need to install Ruby before you start.

Visit http://rubyinstaller.org/downloads/, and download and install the following:

  • Ruby 1.9.3 p448  (Ruby 1.9.3 installer)

Step 2: Install Ruby dev kit

Install the Ruby development kit from http://rubyinstaller.org/downloads/

  • DevKit-tdm-32-4.5.2-20111229-1559-sfx.exe  (Ruby devkit self-extracting executable)
  1. Place the file in a known location (e.g. C:\Ruby_DevKit ).
  2. Extract the dev kit files by running the executable. 
  3. After extraction is complete, change to the DEVKIT installation directory  (e.g.  C:\Ruby_DevKit )
  4. Run the following sequence of commands from the command prompt:

For further info on the Ruby DevKit, see https://github.com/oneclick/rubyinstaller/wiki/Development-Kit

Step 3: Install Dashing gem

At the command prompt, change directory to your Ruby installation base folder. (e.g.  C:\Ruby193 )

install the Dashing gem with the following command:

Step 4: Install bundle gem

At the command prompt, install the bundle gem with the following command:

Step 5: Create new Dashing project

Referring to the Dashing documentation, create a new dashboard project by typing the following:

At this point, everything is good to go, but I found that there was a compatibility issue with the execjs gem file (version 2.0 didn’t play nice…).

To ensure good behaviour, you can force the execjs version to 1.4.0 by modifying the Gemfile:

Now that the Gemfile has been modified, continue with the installation process:

  • Change directory to  sweet_dashboard_project
  • Bundle gems by typing:  bundle 
  • Start dashboard server by typing:  dashing start

At this point, your Dashing dashboard should fire up!

You can access your dashboard at http://localhost:3030/sample
Sample Dashing dashboard

I plan to follow this post with experiences integrating Jenkins status & metrics into Dashing.

Happy dashboarding!

16 thoughts on “Install Dashing dashboard on Windows

  1. Marina

    thanks for this post. your blog post is easier to follow and more blunt than the actual Dashing tutorial, and I am a beginner so need a walkthrough.
    thanks again

    Reply
  2. kindle ebook reader bestellen

    I was wondering if you ever thought of changing the structure of your
    website? Its very well written; I love what youve got to say.
    But maybe you could a little more in the
    way of content so people could connect with it better. Youve
    got an awful lot of text for only having one or two images.
    Maybe you could space it out better?

    Reply
  3. mike

    Thanks for posting this . Really helped get me started . I Ran into abit of an issue on the execjs bit. in the end ended up installing node.js via http://www.nodejs.org/download/ and restarting my pc.

    1 thing to note worth using the tools – jscript console if its failing to display any widgets correctly as you probably ran into the exejs issue.

    Reply
  4. andyw

    I’m a beginner at this but I can’t get it to run or do the execjs thing:
    Gem::RemoteFetcher::FetchError: SSL_connect returned=1 errno=0 state=SSLv3 re
    server certificate B: certificate verify failed (https://rubygems.org/gems/ad
    ssable-2.3.8.gem)
    An error occurred while installing addressable (2.3.8), and Bundler cannot
    continue.
    Make sure that gem install addressable -v '2.3.8' succeeds before bundling.Any ideas?

    Reply
  5. Mohan

    Hello – Hoping someone might help me out here.
    I did follow the steps exactly and when i hit http://localhost:3030/sample, it is not displaying the default widgets but is displaying only “Try this: curl -d ‘{ “auth_token”: “YOUR_AUTH_TOKEN”, “text”: “Hey, Look what I can do!” }’ \http://localhost:3030/widgets/welcome”. Any ideas?

    OS: WIndows 2008 server R2 Enterprise
    Ruby version: ruby 1.9.3p551 (2014-11-13) [i386-mingw32]
    gem version: 1.8.29
    Bundler version 1.9.6

    Best, /Mohan

    Reply
  6. Pingback: Displaying your jamf Pro (Casper Suite) stats in a Dashboard | Sachin Parmar Blog

Leave a Reply

Your email address will not be published. Required fields are marked *