OdooWiki OCA HUB

dbfilter_from_header

dbfilter_from_header folder_open OCA/server-tools open_in_new
Tools License: AGPL-3

This addon lets you pass a dbfilter as a HTTP header.

This is interesting for setups where database names can't be mapped to proxied host names.

auto_awesome What this module does

AI-generated from the code · Odoo 19.0

Allows the database used by Odoo to be selected from an HTTP header instead of the host name. Useful when several databases are served behind a proxy that cannot map each database to its own host name.

This module changes how Odoo decides which database a web request belongs to. Normally Odoo filters the list of available databases using the host name of the request. With this module installed, an extra filter can be supplied through an HTTP header sent by the client or the proxy.

  • The header is read from the request environment under the name HTTP_X_ODOO_DBFILTER.
  • When that header is present, the databases already allowed by the normal host-based filter are further reduced to those whose name matches the pattern given in the header.
  • The pattern is a regular expression, so it can match a prefix, a suffix or a more complex rule.
  • If the header is absent, behaviour is unchanged and the standard host-based filtering applies.

The change only takes effect when Odoo runs in proxy mode and this module is loaded as a server-wide module; otherwise the original filtering is kept. The module does not add any menu, screen, button, report, model or scheduled action, and it does not store any data. It only affects the web request handling layer, so it is invisible in the normal Odoo user interface.

Depends on

web

Text generated by AI (DeepSeek) from reading the Odoo 19.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub

Availability by version

Reviewed: 2026-11-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 8 confirmed, 1 with no information of 9 versions.

Sources · Odoo 19.0

Confirmed on 2026-11-03 in branch 19.0 of OCA/server-tools.

terminal Installation and usage

OCA documentation · Odoo 19.0

To install this module, you only need to add it to your addons, and load it as a server-wide module.

This can be done with the server_wide_modules parameter in /etc/odoo.conf or with the --load command-line parameter

server_wide_modules = base,web,dbfilter_from_header

Please keep in mind that the standard odoo dbfilter configuration is still applied before looking at the regular expression in the header.

  • For nginx, use: proxy_set_header X-Odoo-dbfilter [your filter regex];
  • For caddy, use: proxy_header X-Odoo-dbfilter [your filter regex]
  • For Apache, use: RequestHeader set X-Odoo-dbfilter [your filter regex]

And make sure that proxy mode is enabled in Odoo's configuration file:

proxy_mode = True

To use this module, you need to complete installation and configuration parts.

info

Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.