Releases and upgrading

How we version the app, which Odoo versions it supports, and how to upgrade safely.

Versioning

Releases follow the Odoo convention of the Odoo version followed by the app version, for example 19.0.1.0.2. The app part follows semantic versioning.

Release notes

The full changelog lives on GitHub: buckaroo-it/Odoo/releases, with the same history in CHANGELOG.md.

Read the notes for every version between your current one and your target, not just the target. A breaking change three releases back still affects you.

Get notified of new releases

The quickest way to hear about a new version is to subscribe on GitHub:

1. Open the Odoo repository.
2. Select Watch, then Custom.
3. Tick Releases and save.

You'll then get an email whenever we publish a release, without the noise of every issue and pull request.

You can also subscribe to the Buckaroo status page for incidents and maintenance, which is separate from app releases.

Odoo compatibility

Each Odoo version has its own branch in the repository, and the app version carries the Odoo version in its number. The current release targets:

Always use the branch matching your Odoo version. An app built for a different Odoo release will not work.

Check compatibility before you upgrade Odoo, not after. Upgrading Odoo first can leave your checkout without a working payment provider while you wait.

How to upgrade

Odoo.sh

1. Replace the payment_buckaroo_official folder in your project repository with the new version.
2. Check whether the app's requirements.txt has changed, and update your project's requirements.txt if so.
3. Commit and push, then let the build finish.

Self-hosted

1. Replace the app folder in your addons path with the new version.

2. Install any changed Python dependencies.

3. Upgrade the app:

   Shell

   ./odoo-bin -d YOUR_DATABASE -u payment_buckaroo_official --stop-after-init

4. Restart the Odoo service.

Your provider credentials and payment method settings are preserved across an upgrade.

After upgrading

Select Test Connection on the provider and place one test payment to confirm everything still works. See Test and go live for the scenarios worth re-running.

Contributing

The app is open source. Bug reports, feature requests and pull requests are welcome. See the contribution guidelines, and target the branch matching your Odoo version when opening a pull request.

Security issues should be reported privately to [email protected] rather than in a public issue.