quick_installation.rst

Quick installation

Prerequisites

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<details_ubuntu> for details.

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<details_brew> for details.

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<details_macports> for details.

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

See Gentoo Linux instructions<details_gentoo> for details.

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<details_wsl> 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 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<get_started>!

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

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