Installation Quickstart

This process will install Girder’s prerequisites for a Python 3 environment on common systems.

Basic System Prerequisites

To install basic system prerequisites, run the command:

sudo apt-get install -y python3-venv python3-setuptools python3-dev

To install system prerequisites for Girder’s ldap plugin, run the command:

sudo apt-get install -y libldap2-dev libsasl2-dev

To install basic system prerequisites:

First, enable the Extra Packages for Enterprise Linux YUM repository:

sudo yum -y install epel-release

Then, run the command:

sudo yum -y install python-pip python-virtualenv gcc python-devel curl

To install system prerequisites for Girder’s ldap plugin, run the command:

sudo yum -y install openldap-devel cyrus-sasl-devel

Install Homebrew.

To install all the prerequisites at once just use:

brew install python

Note

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.

Python Virtual Environment (optional)

To create and enable a Python virtual environment, run the commands:

virtualenv -p python3 girder_env
source girder_env/bin/activate
pip install -U pip setuptools

Note

You will need to re-run

source girder_env/bin/activate

in any other shell where you want to install or run Girder.

MongoDB

To install, run the commands:

sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv E162F504A20CDF15827F718D4B7C549A058F8B6B
echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu bionic/mongodb-org/4.2 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-4.2.list
sudo apt-get update
sudo apt-get install -y mongodb-org-server mongodb-org-shell

MongoDB server will register itself as a systemd service (called mongod). To start it immediately and on every reboot, run the commands:

sudo systemctl start mongod
sudo systemctl enable mongod

To install, create a file at /etc/yum.repos.d/mongodb-org-4.2.repo, with:

[mongodb-org-4.2]
name=MongoDB Repository
baseurl=https://repo.mongodb.org/yum/redhat/$releasever/mongodb-org/4.2/x86_64/
gpgcheck=1
enabled=1
gpgkey=https://www.mongodb.org/static/pgp/server-4.2.asc

then run the command:

sudo yum -y install mongodb-org-server mongodb-org-shell

MongoDB server will register itself as a systemd service (called mongod), and will automatically start on every reboot. To start it immediately, run the command:

sudo systemctl start mongod

To install, run the command:

brew install mongodb

MongoDB does not run automatically as a service on macOS, so you’ll need to either configure it as a service yourself, or just ensure it’s running manually via the following command:

mongod -f /usr/local/etc/mongod.conf

Node.js

Node.js v12.0 is the active LTS release, though later versions can also be used instead.

To install, run the commands:

curl -fsL https://deb.nodesource.com/setup_12.x | sudo -E bash -
sudo apt-get install -y nodejs

To install, run the commands:

curl -fsL https://rpm.nodesource.com/setup_12.x | sudo bash -
sudo yum -y install nodejs

To install, run the command:

brew install node

Girder

Proceed to the installation guide to install Girder itself.