The root of the problem
When we install a custom module or one from the Odoo Apps Store, it's common to run into errors that prevent the server from starting correctly. This happens because the Python virtual environment (venv) where Odoo runs doesn't have the additional packages required by the newly installed module. Libraries such as
paramiko,
openpyxl, or specific payment connectors can be essential for its operation.The most frequent error is
ModuleNotFoundError, which indicates that a critical dependency is not present in the virtual environment. If not resolved, the server won't be able to start, blocking access to the platform.
How to interpret the error trace (Traceback)
The first step to resolving this issue is identifying the missing library. To do this, check the Odoo log file, usually located at
/var/log/odoo/odoo.log or in the server's logs folder. Look for the error message that starts with
ModuleNotFoundError followed by the name of the missing module or library.Example of an error in the log:
ModuleNotFoundError: No module named 'paramiko'
Step by step to solve the problem
1. Activate the Odoo virtual environment
First, access the server where Odoo is installed and activate the virtual environment. If you don't know the location of the venv, you can find it in Odoo's configuration file (
odoo.conf) under the
virtual_env option.
Activation example:
source /ruta/al/venv/bin/activate
2. Install the missing dependencies
Once the virtual environment is activated, install the missing library using pip. For example:
pip install paramiko
If the module requires multiple dependencies, check its
requirements.txt file to install them all:
pip install -r requirements.txt
3. Restart the Odoo server
After installing the dependencies, restart the Odoo server for the changes to take effect:
sudo service odoo restart
4. Temporarily disable the conflicting module
If the server still won't start, you can temporarily disable the conflicting module to access Odoo and review the issue. Use the following command:
odoo-bin -d nombre_de_la_bd --stop-after-init -i nombre_del_módulo --uninstall
This will uninstall the module and allow the server to start. Afterward, you'll be able to investigate and resolve the dependency issues before reinstalling it.
Frequently Asked Questions (FAQs)
How can I prevent this type of error?
Before installing a module, check its official documentation to identify the necessary dependencies. Install all required libraries in Odoo's virtual environment before proceeding with the installation.
What should I do if I can’t find the Odoo log file?
Check the server configuration in the
odoo.conf file. The location of the log file is usually defined in the
logfile option.
Is it safe to uninstall a module in production?
Uninstallation should be done with caution, as it may affect data or configurations dependent on the module. It's advisable to back up the database before proceeding.
