Installation

Installation

This page covers installing the OdooPLM server modules into an existing Odoo instance. For the desktop CAD integration, see CAD Client Setup after completing these steps.

Requirements

Requirement	Notes
Odoo	19.0 (this branch). Earlier Odoo versions live on their own branches; pre-v11 is on the legacy SourceForge project.
PostgreSQL	As required by your Odoo version.
Python	As required by Odoo 19.0, plus the packages below.

Python dependencies

The core plm module requires:

base64io

The optional batch conversion module (plm_automated_convertion) additionally requires the packages listed in aaa_requirements.txt:

ezdxf
matplotlib
cadquery
numpy-stl
to-3mf

Install them with:

pip install -r aaa_requirements.txt
# or, minimally, for the core module only:
pip install base64io

Note: cadquery and the mesh/3D libraries are only needed if you intend to use server‑side automated CAD conversion. A standard PLM install does not require them.

1. Get the source

Clone the repository into a directory on your Odoo addons path. The repo uses git submodules (for the 3D / DXF viewer libraries), so clone recursively:

git clone --recurse-submodules -b 19.0 https://github.com/OmniaGit/odooplm.git

If you already cloned without submodules:

git submodule update --init --recursive

2. Add to the addons path

Add the cloned directory to your Odoo configuration (odoo.conf):

[options]
addons_path = /path/to/odoo/addons,/path/to/odooplm

3. Update the apps list and install

Restart Odoo with the new addons path, update the module list, then install the core application:

odoo -c odoo.conf -u all --stop-after-init     # or update the apps list from the UI

From the Odoo Apps menu, search for Product Lifecycle Management and install it (technical name: plm). This pulls in its dependencies automatically: base, board, product, mrp.

Alternatively, install from the command line:

odoo -c odoo.conf -i plm --stop-after-init

4. Install optional modules

OdooPLM is modular. Install only the add-ons you need from the Apps menu, or via -i. For example:

odoo -c odoo.conf -i plm,plm_engineering,plm_web_3d,plm_web_revision --stop-after-init

See the Modules Reference for the complete catalogue and dependencies.

Developer / test flags

When developing or testing, the following Odoo arguments are useful:

# Auto-reload XML views when you edit them
--dev=xml

# Run the PLM test suites
--test-tags=odoo_plm,odoo_plm_web_revision,plm_automatic_weight

Optional: mirror document server

mirror_document_server/ is a standalone Flask service (not an Odoo module) used to mirror/replicate PLM documents to a remote storage node. It depends on flask and flask_httpauth. Use it together with the plm_document_multi_site module for multi-site document synchronization. It is only needed in distributed deployments.

Next steps

• ➡️ CAD Client Setup — connect SolidWorks / Solid Edge / AutoCAD etc.
• ➡️ Core Concepts — understand revisions, BOMs and the workflow.