System Prerequisites

The following software packages are required to be installed on your system:

Additionally, in order to send out emails to users, Girder will need to be able to communicate with an SMTP server. Proper installation and configuration of an SMTP server on your system is beyond the scope of these docs, but we recommend setting up Postfix.

See the specific instructions for your platform below.

Debian / Ubuntu

Install the prerequisites using APT:

sudo apt-get install curl g++ git libffi-dev make python-dev python-pip

MongoDB 2.6 requires a special incantation to install at this time. Install the APT key with the following:

sudo apt-key adv --keyserver hkp:// --recv 7F0CEB10

For Debian, create the following configuration file for the MongoDB APT repository:

echo 'deb dist 10gen' \
    | sudo tee /etc/apt/sources.list.d/mongodb.list

For Ubuntu, instead create the following configuration file:

echo 'deb dist 10gen' \
    | sudo tee /etc/apt/sources.list.d/mongodb.list

Reload the package database and install MongoDB server using APT:

sudo apt-get update
sudo apt-get install mongodb-org-server

Enable the Node.js APT repository:

curl -sL | sudo bash -

Install Node.js and NPM using APT:

sudo apt-get install nodejs

CentOS / Fedora / Red Hat Enterprise Linux

For CentOS and Red Hat Enterprise Linux, enable the Extra Packages for Enterprise Linux YUM repository:

sudo yum install epel-release

Install the prerequisites using YUM:

sudo yum install curl gcc-c++ git libffi-devel make python-devel python-pip

Create a file /etc/yum.repos.d/mongodb.repo that contains the following configuration information for the MongoDB YUM repository:

name=MongoDB Repository

Install MongoDB server using YUM:

sudo yum install mongodb-org-server

Enable the Node.js YUM repository:

curl -sL | sudo bash -

Install Node.js and NPM using YUM:

sudo yum install nodejs


It is recommended to use Homebrew to install the required packages on OS X.

To install all the prerequisites at once just use:

brew install python mongodb node


OS X ships with Python in /usr/bin, so you might need to change your PATH or explicitly run /usr/local/bin/python when invoking the server so that you use the version with the correct site packages installed.



Windows is not supported or tested. This information is provided for developers. Use at your own risk.

Download, install, and configure MongoDB server following the instructions on the MongoDB website, and download and run the Node.js Windows Installer from the Node.js website.

Download and install the Windows MSI Installer for the latest Python 2 release from the Python website, and then download and run the bootstrap script to install Setuptools for Python. You may need to add python\scripts to your path for NPM to work as expected.

From a command prompt, install pip:

easy_install pip

If bcrypt fails to install using pip (e.g., with Windows 7 x64 and Python 2.7), you need to remove the line for bcrypt from the requirements.txt file and manually install it. You can build the package from source or download a wheel file from and install it with the following:

pip install wheel
pip install py_bcrypt.whl