When something does not work
This page lists what actually goes wrong, in the order it goes wrong, with the fix. Work through it before writing to us - it will be faster, and in most cases the answer is here.
The app does not appear in the Apps list
You almost certainly skipped Update Apps List, or the Apps filter is still on. See installing a BambooForge app, steps 4 and 5.
If it still does not appear, Odoo is not reading the directory you copied it into. Check that the parent directory is on addons_path, that the module directory contains __manifest__.py directly inside it (not nested one level deeper - a common result of unzipping twice), and that the Odoo process user can read the files.
Installation fails with a dependency error
The message names a module that is missing. If the name starts with bambooforge_, it is one of ours and you need to install it too - the app page on this site lists what each app depends on. If the name does not start with bambooforge_, it is a standard Odoo module: install it from Apps first. If it is an Enterprise module and you run Community, that app needs Enterprise; its page says so.
Installation fails with an XML or field error
This is nearly always a version mismatch: the app is built for a different Odoo series than the one you are running. Confirm your Odoo version in Settings ▸ Developer Tools ▸ About and confirm the app series on its page here. If they match and it still fails, send us the full traceback - see below.
Nothing changed after I upgraded
Copying new files over old ones does not upgrade the database. You have to run Apps ▸ the app ▸ Upgrade, or start Odoo once with -u <module_name>. Assets - JavaScript and CSS - are cached hard; after an upgrade, reload with the browser cache disabled once.
A report or PDF comes out wrong
Odoo renders PDFs with wkhtmltopdf, and the wrong build produces headers and footers that overlap or vanish. Check Settings ▸ Developer Tools ▸ About: if it warns about your wkhtmltopdf version, that is the cause, and it affects every report in your Odoo, not only ours.
Performance got worse after installing
Tell us. Include which list or form is slow, roughly how many records it holds, and the query log if you can get one (--log-level=debug_sql). We treat this as a defect, not a support question.
Writing to us
Send to support@bambooforge.dev, and include:
the app name and the version string from Apps ▸ the app,
your Odoo version and whether it is Community or Enterprise,
how you host it: self-hosted, Odoo.sh, or a provider,
the full traceback, as text, from the Odoo server log - not a screenshot of the browser error,
what you did, in the order you did it.
A report with the traceback is usually answered in one round. A report without one costs two or three, and the delay is entirely in that exchange.