Quick installation

Prerequisites

Ubuntu

sudo apt-get install git python2.7-dev python3-dev python-pip virtualenv postgresql postgresql-server-dev-all postgresql-client rabbitmq-server

See Ubuntu instructions for details.

MacOS X (Homebrew)

brew install git python postgresql rabbitmq
brew services start postgresql
brew services start rabbitmq

You also need to install pip and virtualenv. See for example this page (untested): https://www.andreagrandi.it/2018/12/19/installing-python-and-virtualenv-on-osx/

See MacOS X (Homebrew) instructions for details.

MacOS X (MacPorts)

sudo port install git python postgresql96 postgresql96-server rabbitmq-server
pg_ctl -D /usr/local/var/postgres start

You also need to install pip and virtualenv. See for example this page (untested): https://truongtx.me/2014/02/25/mac-os-install-python-pip-virtualenv-using-macports

See MacOS X (MacPorts) instructions for details.

Gentoo Linux

emerge -av git python postgresql rabbitmq-server
rc-update add rabbitmq

See Gentoo Linux instructions for details.

Windows Subsystem for Linux

sudo apt-get install git python2.7-dev python3-dev python-pip virtualenv postgresql postgresql-server-dev-all postgresql-client
sudo service postgresql start
# install rabbitmq on windows

See WSL instructions for details.

Installation

Create and activate a virtual environment:

virtualenv ~/.virtualenvs/aiida
source ~/.virtualenvs/aiida/bin/activate

Install the aiida-core python package:

pip install --pre aiida-core
reentry scan

Set up your AiiDA profile:

verdi quicksetup

Start the AiiDA daemon process:

verdi daemon start

Check that all services are up and running:

verdi status

 ✓ profile:     On profile quicksetup
 ✓ repository:  /repo/aiida_dev/quicksetup
 ✓ postgres:    Connected to aiida@localhost:5432
 ✓ rabbitmq:    Connected to amqp://127.0.0.1?heartbeat=600
 ✓ daemon:      Daemon is running as PID 2809 since 2019-03-15 16:27:52

If you see all checkmarks, it is time to get started!

If the quick installation fails at any point, please refer to the full installation guide for more details or the troubleshooting section.

For configuration of tab completion or using AiiDA in jupyter, see the configuration instructions before moving on.