BFBambooForge Labs

Installing a BambooForge app

Every app on this site installs the same way. Nothing here needs a licence key, a server of ours, or an internet connection at runtime.

Before you start

Check three things. Getting one of them wrong is the cause of almost every installation that fails.

The series must match. An app built for Odoo 17 will not install on Odoo 18. Each app page on this site lists the Odoo versions it is published for; buy the one that matches the Odoo you run. Look at Settings ▸ Developer Tools ▸ About if you are not sure which that is.

Community or Enterprise. Every app here runs on both, unless its own page says otherwise.

You need filesystem access to the Odoo server. Odoo has no way to install a third-party module through the browser. If your Odoo is hosted on Odoo Online (.odoo.com), you cannot install any third-party app at all - that is an Odoo platform restriction, not ours. Odoo.sh and self-hosted both work.

Install

  1. Unzip the app into a directory on your addons_path. If you are unsure which directories those are, run odoo-bin --help or read the addons_path line of your odoo.conf.

  2. Restart Odoo. The module list is read at startup.

  3. In Odoo, turn on developer mode: Settings ▸ General Settings, scroll to the bottom, Activate the developer mode.

  4. Go to Apps and click Update Apps List. This step is what makes a newly copied module appear; skipping it is the single most common reason people report "the app is not there".

  5. Clear the Apps filter in the search box - Odoo hides non-app modules by default - then search the app by name and click Activate.

On Odoo.sh, commit the module into your repository's addons directory instead and let the build run; steps 3 to 5 are the same afterwards.

Upgrading to a newer build

Replace the directory with the new one, restart Odoo, then Apps ▸ find the app ▸ Upgrade. Do not uninstall first: uninstalling deletes the records the app created.

Take a database backup before upgrading. This is ordinary advice for any Odoo module and we repeat it because recovering without one is not possible.

Uninstalling

Apps ▸ find the app ▸ Uninstall. Odoo removes the models, fields and records the app owns. Data you entered into those fields goes with them. Export anything you want to keep first.