← Back to OdooWoo
Guide · 5 min read

Install & activate the OdooWoo helper module

Use this checklist whenever you deploy a fresh Odoo environment or move to a new server. It keeps the WooCommerce integration helpers in lockstep with your ERP.

  1. 1. Clone the helper module

    SSH into your Odoo server, change into your custom-addons path (e.g. /opt/odoo-16/custom-addons/), and clone or pull the helper module directly on the server so it stays current.

    ssh odoo@your-server "cd /opt/odoo-16/custom-addons && (git clone https://github.com/beltoftandersen/odoowoo-helper-module.git odoowoo_helper 2>/dev/null || (cd odoowoo_helper && git pull --ff-only))"

  2. 2. Set file ownership and permissions

    Ensure the directory uses the same owner/group as Odoo and has read permissions. Adjust the user/group if yours differs from 'odoo'.

    sudo chown -R odoo:odoo /opt/odoo-16/custom-addons/odoowoo_helper && sudo chmod -R 755 /opt/odoo-16/custom-addons/odoowoo_helper

  3. 3. Update addons_path in odoo.conf

    Add your custom-addons directory to 'addons_path' in odoo.conf so the helper is in the load path. Example: addons_path = /opt/odoo-16/custom-addons,/opt/odoo-16/odoo/addons. The location of odoo.conf varies depending on your installation.

  4. 4. Restart Odoo

    Restart the Odoo service so it rescans the addons directories.

    sudo systemctl restart odoo

  5. 5. Verify Inventory and Sales apps

    In Odoo, confirm the Inventory and Sales applications are installed (install them from Apps if they are missing) because the helper module relies on those models.

  6. 6. Activate the module

    Enable developer mode (Settings → Activate Developer Mode), open Apps, click Update Apps List to refresh the module registry. Clear the default Apps filter in the search field, then search for odoowoo_helper and activate it.

  7. 7. Run a test sync

    Run a quick sync from OdooWoo to confirm the helper module works correctly with your WooCommerce and Odoo objects.

Next steps