sitestatus-nonrel is an easy-to-use web application that creates a dynamic, self-updating status page for your domain or any arbitrary collection of sites you might want to track the status of.

• Python 2.x
• Django 1.x
• Google App Engine SDK for Python

Make sure you have the prerequisites listed above installed. Next, download the latest version of sitestatus-nonrel. Unzip the archive to any directory on your file system.

Alternatively, you can clone the git repository by executing

git clone git://github.com/sclabs/sitestatus-nonrel.git

Feel free to fork the repository and develop your own tweaks and features under the conditions of the license (see below).

1. Go to appengine.google.com, log in with your Google Account, and follow the instructions to enable Google App Engine for your account (if you haven’t done so already).
2. Create a new app, and remember your app’s application identifier.
3. In app.yaml, replace myapp with the application identifier for your app.
4. In sitestatus_nonrel/settings.py, change SITE_TITLE from 'My Awesome Status Page' to whatever you actually want to call your site.
5. Run python manage.py deploy and authenticate with your Google Account when prompted.
6. Run python manage.py remote createsuperuser to create a superuser for yourself.
7. Point your browser to your_application_identifier.appspot.com/admin/
8. Click on “Statuses” and then “Add status”. Fill out all the fields (see below for help with “Update type” and the optional fields) and click “Save”.

It’s that simple! Point your browser to your_application_identifier.appspot.com to see your status page!

Update Types

sitestatus-nonrel features four different ways to check the status of any given site, which you can change by modifying the “Update type” property of the Status you want to change through the admin interface. These are:

1. none – This is the default update type, which causes the update mechanism to ignore this site and never update its status. Use this for custom statuses like “coming soon”, etc.
2. status – This is probably the update type you will use most. It tells the update mechanism to send a request to the url in “Update url”. If the response has a status code of `200 OK`, the status will be updated to “online”. Otherwise, it will be updated to “offline”.
3. title – This update type looks at the title of the webpage at “Update url” and checks to see if it contains the string in “Update title”.
4. content – This update type looks at the entire content of the HTTP response returned by the site at “Update url” and checks to see if it contains the string in “Update content”.

Domain Setup

If you have a domain you’d like to host your status page on, you can add a domain to your app by going to the Application Settings page on your Google App Engine dashboard.

Site Themes

The templates directory contains a bare-bones example template (index.html) that you should feel free to modify and style however you like.

Need Help?

Direct all questions, comments, and bug reports to sclabs@gilgi.org.

sitestatus-nonrel is released under the terms of the GNU General Public License, the full text of which is available in the file GPL. For details, please visit www.gnu.org/licenses/gpl.html.

Modules from the django-nonrel project are redistributed under the terms of the license found in the file LICENSE.