OdooWiki OCA HUB

External Database Sources

base_external_dbsource folder_open OCA/server-backend open_in_new
Tools License: LGPL-3

This module allows you to define connections to foreign databases using ODBC, Firebird, Oracle Client or SQLAlchemy.

auto_awesome What this module does

AI-generated from the code · Odoo 19.0

Lets administrators register connections to external databases (currently PostgreSQL) and test them from Odoo. Other modules can then run queries or read/write records on those external databases.

This module adds a new screen where administrators can store the details of an external database: a datasource name, the connection string, an optional password, a company, and the connector type. Only PostgreSQL is available as a connector in this version.

Where it appears: - A new menu "Database Sources" under the Settings area opens a list of external database sources. - The form shows the name, company, connector, password, the connection string, and a "Test Connection" button.

Business rules and automatic behaviour: - The full connection string is computed automatically from the connection string and password; if the password is set and the string has no placeholder, a password fragment is appended before substitution. - "Test Connection" opens the connection and shows a success or failure message. - A multicompany rule restricts each source to its company (or sources with no company). - Only users in the system administrator group can create, edit, or delete these records.

What it touches: - It defines the base.external.dbsource model and its list and form views. - It provides methods that other modules can call to open/close a connection, execute a query, and browse, create, update, search, or delete records on the remote database, using the selected connector.

Depends on

base

Menus it adds

Database Sources
Models and fields (1)
  • base.external.dbsource · new modelname (Datasource name), ca_certs, password, connector, client_key, company_id (Company), client_cert, conn_string (Connection string), conn_string_full

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 16.0

Confirmed on 2026-11-03 in branch 16.0 of OCA/server-backend.

terminal Installation and usage

OCA documentation · Odoo 19.0

No installation required.

To configure this module, you need to:

  • Database sources can be configured in Settings \> Technical \> Database Structure \> Data sources.
  • Go to Settings \> Technical \> Database Structure \> Database Sources
  • Click on Create to enter the following information:
  • Data source name
  • Password
  • Connector: Choose the database to which you want to connect
  • Connection string: Specify how to connect to database
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.