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.0Allows 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
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-03Confirmation status: 8 confirmed, 1 with no information of 9 versions.
Sources · Odoo 17.0
Confirmed on 2026-11-03 in branch 17.0 of OCA/server-tools.
terminal Installation and usage
OCA documentation · Odoo 19.0Installation
Source · Odoo 19.0To 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
Configuration
Source · Odoo 19.0Please 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
Usage
Source · Odoo 19.0To use this module, you need to complete installation and configuration parts.
Installation instructions, the distribution package, dependencies and configuration steps are not shown because they have not yet been verified in the module documentation for any version.
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.