Skip to content
Stashboard, now with less vendor lock-in.
Python CSS
Find file
Latest commit fe157c1 Jon Chen Merge pull request #14 from fly/run_locally
document running locally
Failed to load latest commit information.
board Quick fix
settings remove lingering epio references
static Timezone
templates Timezone
.gitignore remove epio stuff
LICENSE Initial commit document running locally fixes bfirsh/whiskerboard#1 Initial commit remove epio stuff Initial commit
requirements.txt remove epio stuff Added feed


Whiskerboard is a status board for websites, services and APIs, like Amazon's AWS status page.

It is heavily based on Stashboard. Unlike Stashboard, it uses vanilla Django, so you aren't stuck using Google App Engine.

Have a look at the demo:

Quick start guide

It's dead quick to get a status board up and running using

Create an application on then run these two commands, replacing myamazingboard with the name of your application:

$ pip install -r requirements.txt
$ fab app:myamazingboard deploy

You might need to install pip. If you haven't got a virtualenv, you'll need to run it as root too.


The configuration files are located in the setting directory, with being the most relevant.

You'll want to edit the following configuration options accordingly:

    'default': {
        'ENGINE': 'django.db.backends.postgresql_psycopg2',
        'NAME': 'whiskerboard',
        'USER': 'whiskerboard',
        'PASSWORD': 'supersekritpassword',
        'HOST': 'localhost',
        'PORT': '5432',


    ('Your Name', ''),

Run locally

Use the following command to run whiskerboard locally using the built in Python webserver:

$ ./ runserver

Now head over to and login with the account you created when you deployed. You'll want to set the name of your board by clicking on "sites". Edit the single entry called "" and enter a name for your board.

Back on the admin home page, click on "services" and add the things you want to report the status of (website, API etc). To change the status of a service add an event for it.

Something went wrong with that request. Please try again.