How to install and upgrade Odoo add-ons
Install and upgrade Odoo modules (add-ons) over SSH on TurboStack using odoo-bin and the systemd user service.
Overview
Upgrade or install Odoo modules using command-line tools. TurboStack servers provide optimal system configurations, but managing Odoo itself remains your responsibility. For the file layout and service details, see Odoo reference.
Important
To safely test new modules or updates, use a separate staging server. Do not run staging environments locally on the same production host.
Why separate servers?
- Prevents production disruption.
- Isolates tests and experiments.
- Maintains better performance and security.
TurboStack offers affordable and optimized staging environments. Contact support to request a staging clone of your production Odoo.
Upgrade an add-on
systemctl --user stop application.service
~/application/odoo/odoo-bin -u <module_name> -c ~/conf/odoo.conf --stop-after-init
systemctl --user start application.service
Replace <module_name> with your actual add-on/module name.
Install a new add-on
- Upload the module to
~/application/custom/. - Run:
systemctl --user stop application.service
~/application/odoo/odoo-bin -i <module_name> -c ~/conf/odoo.conf --stop-after-init
systemctl --user start application.service
Notes
- Always stop the service before upgrades.
- Make sure your add-on contains a valid
__manifest__.pyfile. - Keep your structure modular by creating symbolic links inside
~/application/custom/for large or custom add-on libraries, rather than copying whole trees in. - Always keep your
.envandodoo.confsafe and backed up before changing modules, so you can restore a known-good configuration if an upgrade goes wrong.
Related
- Odoo reference
- How to install Python dependencies for Odoo
- Deploy Odoo on TurboStack
- Odoo best practices
- Troubleshooting Odoo
- How to manage user system services
- Connect over SSH