Skip to content
CSS JavaScript Python
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Welcome to Dormbase.

Dormbase is a web-based system that provides MIT dormitories with the tools and services they need for daily operation. It is an open source software project that was started by Simmons Tech in response to their and the resident's need for reliable, modern, and user-friendly online services. Dormbase means a consistent user experience across all of MIT's dorms, accessible to residents, desk workers, and administration. It is a community project that solves a community problem.

Learn About GitHub

Get Started

  • RECOMMENDED: Create a python virtualenv environment, by running virtualenv DIR, and then activate it by running source DIR/bin/activate.
  • Install the dependencies
  • Finish following the Dev Server Setup - and take the shortcut, if you can!
  • Run the server:
    • python runserver
    • Visit http://localhost:8000/ in your web browser

Setting up search locally

You should almost certainly skip this step. If for some reason you need search to work locally, set up Whoosh.

  • Edit dormbase/ to comment out:

And right below, add these two lines:

HAYSTACK_WHOOSH_PATH = 'whoosh_index/'
  • Then run python rebuild_index


This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see

Something went wrong with that request. Please try again.