Upgrading

Some releases require extra steps. Please read the release notes before you begin.

We test the upgrade path thoroughly before each release but even so, you should always make a backup first!

git pull origin main
source venv/bin/activate
pip install --upgrade pip
pip install -r ./requirements.txt
flask db upgrade

Check list

Some releases require extra steps. Use this check list to ensure your installation is up-to-date.

For example, when upgrading from v4.1.0 to latest, read all the notes added to list after your current version.

v4.11.0

Default language

The DEFAULT_LANGUAGE value syntax defined in .env has changed.

Please see dotenv.example for valid values.

Form structure

LiberaForms now does strict form field sanitization when feild edition is saved. Use this command to sanitize the older forms in your database.

flask form sanitize-structure --help

This will also remove valid field properties that are not used by LiberaForms, so you can expect that all (or nearly all) of your forms are updated on the first run.

This command replaces flask site repair-forms first introduced in v4.8.1 to fix a bug.

v4.9.0

Container volumes.

logs and uploads are now managed by the container engine. You will need to create the volumes and copy your existing data.

https://blog.liberaforms.org/2026/06/02/version-490/#container-volumes

v4.8.1

We found a bug that causes some forms to fail to render. You should preventively repair the forms on your installation.

flask site repair-forms

v4.7.0

LiberaForms now requires Python 3.10 or greater.

Please check your version and install if necessary before continuing.

https://blog.liberaforms.org/2026/02/05/version-470/#installing-python

v3.2.0

Your nginx vhost should accept uploads greater than the limit MAX_ATTACHMENT_SIZE defined in your .env file.

https://blog.liberaforms.org/2024/07/04/version-320/#update-nginx-config