Quick Menu

Bookworm migration isues FAQ

This page lists all the known issues encountered after a migration from YunoHost 11 to 12.

If the suggested solutions don't work, please ask for help.

Python apps

After upgrading, your python apps should be unavailable because their virtual environment (venv) needs to be rebuilt.

To do that you can run the pending migrations in Webadmin > Update.

The apps below won't be automatically repaired, you need to force-upgrade them manually instead with yunohost app upgrade -F APP.

Apps which won't be automatically repaired and need a force upgrade:

  • borgserver and all its instances (eg. borgserver2, borgserver3, ...)

TODO: list those apps

FIXME:??!!! If needed, you can disable the automatic rebuild for a specific python app, by removing the dedicated file ending with .requirements_backup_for_bullseye_upgrade.txt before applying the migration. You can find this file near the venv (Python virtual environment) of your app inside /var/www.

Error 500 everywhere

The web server, nginx, might need a restart before being fully operational. Please run this command:

sudo systemctl restart nginx

Found errors? Think you can improve this documentation? Simply click the Edit link at the top of the page, and then the icon on Github to suggest changes.