FAQ Troubleshooting

FAQ & Troubleshooting

General

What Odoo versions are supported? This repository targets Odoo 19.0. Other versions live on their own branches; everything before Odoo v11 is on the legacy SourceForge project.

Is it really free / open source? Yes. The core module plm is LGPL-3, so it can be integrated into other products, proprietary ones included. Every other module is AGPL-3 — extend one, distribute it or serve it over a network and the result must be published under the same licence. Each module's __manifest__.py is the authoritative source; see Modules Reference. The desktop CAD client is proprietary, and OmniaSolutions offers commercial support, training and implementation on top.

Which CAD editors are supported? SolidWorks, Solid Edge, Autodesk Inventor, AutoCAD, ThinkDesign, FreeCAD and DraftSight, through the desktop client.

Do I need to install all the modules? No. Install the core plm module, then add only the optional modules whose features you need. See the Modules Reference.

What is the quickest way to see OdooPLM working? Run the -demo Docker image: docker compose up gives you Odoo, PostgreSQL and a populated PLM database (admin / admin). On an existing instance, install the plm_demo module for the same content.

Installation

base64io / import errors. base64io is a dependency of plm_pack_and_go, not of the core plm module (which declares no external Python dependency at all). Install it with pip install base64io, or skip that module.

Errors mentioning cadquery, ezdxf, numpy-stl, matplotlib. These are only required by plm_automated_convertion (server-side CAD conversion). Either install them (pip install -r aaa_requirements.txt) or don't install that module. The slim Docker image is built for exactly this case.

googletrans / polib errors. Those belong to plm_auto_translator. Install them or skip the module.

The 3D / DXF viewer is missing or broken in plm_web_3d. That module bundles three.js and dxf-viewer as git submodules. Make sure you cloned recursively, or run git submodule update --init --recursive.

A module won't install because of a missing dependency (mrp_workorder, helpdesk). Some modules require Odoo Enterprise apps — plm_pdf_workorder_enterprise needs mrp_workorder, and plm_ent_breakages_helpdesk needs helpdesk. Install the Enterprise dependency first, or skip the module if you're on Community.

Docker

Which image should I pull? full (~4.4 GB) carries the CAD conversion stack for plm_automated_convertion; slim (~2.5 GB) leaves it out. Both ship every community PLM module in the addons path. Add -demo to either tag to boot on a populated database. See Docker.

The container starts but the database is empty. That is the non-demo image: it creates the odooplm database and installs plm, and you pick the rest from the Apps menu. Use a -demo tag, or install plm_demo, if you want the sample product.

How do I reset a demo stack? docker compose down --volumes deletes the database and the filestore; the next docker compose up rebuilds them.

The CAD client can't reach my container. The container exposes 8069, the client expects HTTP on port 80 — put a reverse proxy in front of it or map the port.

CAD client connection

The client can't reach the server. The client connects over HTTP on port 80 — not directly on 8069. Ensure a reverse proxy or the host exposes port 80. See the login guide for the Odoo.sh case.

Login fails with valid credentials. Check that (a) the correct database is selected when multiple DBs are hosted, and (b) the Odoo user has the PLM access rights.

I want to test without my own server. Use the public demo at https://v19.odooplm.cloud, user admin, password admin — or run the -demo Docker image locally, same credentials. The older v15.odooplm.cloud host is no longer online.

Usage

Why can't I select a product in a sale/purchase/MO? If you installed an "only latest" module (plm_sale_only_latest, plm_purchase_only_latest, plm_product_only_latest), only items in their latest released revision (with an engineering code) are selectable. Release the latest revision, or remove the restriction module.

How do I see what changed between two revisions? Use plm_compare_bom to diff the two BOMs.

How do I withdraw an old part? Install plm_suspended to get the Obsoleted state, then move the item to it.

Can I remove the demo data afterwards? Yes. plm_demo creates everything through the ORM with proper external ids, so uninstalling the module removes it again. Still, don't install it on a production database.

Getting help

• 🐛 Open an issue
• 📘 Official documentation
• 🐳 Docker images & Compose stack
• 🎬 Video tutorials
• 📧 info@omniasolutions.eu — commercial support and a hosted test environment