This process will install Girder's prerequisites for a Python 2 environment on common systems.
.. group-tab:: Ubuntu 16.04
To install basic system prerequisites, run the command:
sudo apt-get install -y python-pip python-virtualenv
To install system prerequisites for Girder's ldap
plugin, run the command:
sudo apt-get install -y libldap2-dev libsasl2-dev
Ubuntu 14.04
To install basic system prerequisites, run the command:
sudo apt-get install -y python-pip python-virtualenv python-devTo install system prerequisites for Girder's
ldap
plugin, run the command:sudo apt-get install -y libldap2-dev libsasl2-devRHEL (CentOS) 7
To install basic system prerequisites:
First, enable the Extra Packages for Enterprise Linux YUM repository:
sudo yum -y install epel-releaseThen, run the command:
sudo yum -y install python2-pip python-virtualenv gcc python-devel curlTo install system prerequisites for Girder's
ldap
plugin, run the command:sudo yum -y install openldap-devel cyrus-sasl-develmacOS
Install Homebrew.
To install all the prerequisites at once just use:
brew install pythonNote
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.
To create and enable a Python virtual environment, run the commands:
virtualenv 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.
.. group-tab:: Ubuntu 16.04
To install, run the commands:
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 2930ADAE8CAF5059EE73BB4B58712A2291FA4AD5
echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu xenial/mongodb-org/3.6 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-3.6.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
Ubuntu 14.04
To install, run the commands:
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 2930ADAE8CAF5059EE73BB4B58712A2291FA4AD5 echo "deb [ arch=amd64 ] https://repo.mongodb.org/apt/ubuntu trusty/mongodb-org/3.6 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-3.6.list sudo apt-get update sudo apt-get install -y mongodb-org-server mongodb-org-shellMongoDB server will register itself as an Upstart service (called
mongod
), and will automatically start immediately and on every reboot.RHEL (CentOS) 7
To install, create a file at
/etc/yum.repos.d/mongodb-org-3.6.repo
, with:[mongodb-org-3.6] name=MongoDB Repository baseurl=https://repo.mongodb.org/yum/redhat/$releasever/mongodb-org/3.6/x86_64/ gpgcheck=1 enabled=1 gpgkey=https://www.mongodb.org/static/pgp/server-3.6.ascthen run the command:
sudo yum -y install mongodb-org-server mongodb-org-shellMongoDB 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 mongodmacOS
To install, run the command:
brew install mongodbMongoDB 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 v8.0 is the active LTS release, though later versions can also be used instead.
.. group-tab:: Ubuntu 16.04
To install, run the commands:
curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash -
sudo apt-get install -y nodejs
Ubuntu 14.04
To install, run the commands:
curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash - sudo apt-get install -y nodejs
RHEL (CentOS) 7
To install, run the commands:
curl --silent --location https://rpm.nodesource.com/setup_8.x | sudo bash - sudo yum -y install nodejs
macOS
To install, run the command:
brew install node
Proceed to the installation <installation>
guide to install Girder itself.