Comment on page

Installing your own version of Quantum Espresso

These instructions are for users who need to install their own version of Quantum Espresso.
Do not load the 'quantumespresso' module. If you have a 'quantumespresso' module loaded, unload it:
module unloadquantumespresso
Step 1: Create a new directory where you want to install Quantum Espresso:
mkdir -p quantum-espresso/src
cd quantum-espresso/src/
Step 2: Download the version of Quantum Espresso you want from the GitHub repo:
tar xvf qe-6.4.tar.gz
cd q-e-qe-6.4/
Step 3: Load the newer compiler module and configure it with custom flags.
module load intel/2020.2
CC=icc CXX=icpc F77=ifort FC=ifort ./configure --prefix=/users/<username>/data/quantum-espresso/
  • Configuration options
    • Compiling with MPI
    module load mpi/<version>
    # load the mpi module dependencies
    CC=icc CXX=icpc F77=ifort FC=ifort ./configure --prefix=/users/<username>/data/quantum-espresso/
    • Compiling with optimized libraries (boost & hdf5)
    module load mpi/<version>
    module load hdf5/1.10.5_fortran fftw/3.3.6
    # load the mpi module dependencies
    CC=icc CXX=icpc F77=ifort FC=ifort ./configure --prefix=/users/<username>/data/quantum-espresso/ --with-hdf5=/gpfs/runtime/opt/hdf5/1.10.5_fortran LIBDIRS=/gpfs/runtime/opt/fftw/3.3.6/lib
More configuration options can be found here.
The --prefix PATH will be replaced by your custom install location
Step 4: If you are happy with the configure flags then install them by:
make install
Step 5 (Optional): Adding QuantumEspresso to your path
Add the following lines to your ~/.bashrc
export PATH=/users/<username>/data/quantum-espresso/bin:$PATH
export BIN_DIR=/users/<username>/data/quantum-espresso/bin
Restart the Oscar session or source .bashrc

Installing custom Addon patches for Quantum Espresso

There are various addons available for Quantum Espresso, in this tutorial, we will install Environ - a computational library aimed at introducing environment effects to atomistic first-principles simulations.
The source code can be obtained from this github repo. The easiest way to incorporate these files into your build is to place them in the root directory of Quantum Espresso (~/data/quantum-espresso/src/q-e-qe-6.4). For example:
git clone
  1. 1.
    run the QE script with the -patch option:
    ./install/ Environ Environ/src Modules -patch
  2. 2.
    run the Environ installation script with the -patch option:
    ./Environ/patches/ -patch
  3. 3.
    run the QE script to regenerate modules’ dependencies:
  4. 4.
    re-compile, e.g.:
    make pw

Installing with QMCPACK

  1. 1.
    Download QMCPACK
    git clone
  2. 2.
    Copy *.diff and *.sh files from qmcpack to QE/src folder
  3. 3.
    Patch QuantumEspresso
  4. 4.
    Follow the steps above for Installing Quantum Espresso