Documentation — installation and setup

Installation

Copy the module

Put the folder woodpecker_bug_tracker into addons_path. Odoo Online does not support custom modules directly — installation will be available once the module is published in Odoo Apps.

Update the apps list

Developer mode → Apps → Update Apps List → find “Bug Report” → Install.

Or from the console

odoo -c /etc/odoo/odoo.conf -d your_db -i woodpecker_bug_tracker --stop-after-init

Assign groups

Settings → Users & Companies → Groups → Bug Report.

Roles

Group	Rights
QA Tester	Creating and managing bugs
Bug Report Manager	Everything above + stage and tag configuration, deletion

Quick start

Click the bug icon in the systray.
Enter a title — the tracker will warn you about duplicates.
Fill in the template: steps, expected, actual.
Add up to 3 screenshots and annotate them if needed.
Submit — the bug appears in the New stage.

Lifecycle

Once a bug leaves “New”, its description is locked. A resolution is required to close it. A closed bug can be brought back with the Reopen button — the reason is logged in Chatter.

Requirements

Odoo 19 and newer
Module mail
No external Python dependencies needed
HTTPS on the Odoo server — for screen capture and pasting from the clipboard (file upload and drag & drop work without it)