Before you update your AiiDA installation, please:
- Enter the python environment where AiiDA is installed
- Stop your daemon by executing
verdi daemon stop
- Create a backup of your database(s) by following the guidelines in the backup section
- Create a backup of the
~/.aiidafolder (where configuration files are stored)
If you have installed AiiDA through
pip install --upgrade aiida-core
If you have installed AiiDA from a local clone of the
repository, enter the directory of the local clone and run:
find . -name "*.pyc" -type f -delete # deletes pre-compiled python files git checkout <desired-branch> git pull pip install -e .
After upgrading AiiDA, you may need to migrate your AiiDA database to the latest
version of the schema.
If migrations are required, running any
verdi command will automatically raise an exception
and print the instructions for performing the migrations.
aiida.common.exceptions.ConfigurationError: Database schema version 1.0.19 is outdated compared to the code schema version 1.0.20 To migrate the database to the current version, run the following commands: verdi -p quicksetup daemon stop verdi -p quicksetup database migrate
Once the migrations have been performed, start the daemon and you are done.
Each version increase may come with its own necessary migrations and you should
only ever update the version by one at a time.
Therefore, first get the version number from
Version migration instructions¶
Updating from 0.12.* to 1.0¶
- The tab-completion activation for
verdihas changed, simply replace the
eval "$(verdi completioncommand)"line in your activation script with
eval "$(_VERDI_COMPLETE=source verdi)"
Updating from older versions¶
To find the update instructions for older versions of AiiDA follow the following links to the documentation of the corresponding version:
- 0.8.* Django
- 0.7.* Django
- 0.6.* Django
- 0.6.* SqlAlchemy
- 0.5.* Django
- 0.4.* Django
0.9.0, we use Alembic for the database migrations of the
SQLAlchemy backend. In case you were using SQLAlchemy before the introduction
of Alembic, you may experience problems during your first migration. If it is
the case, please see this section.