Skip to content

Odoo configuration file (odoo.conf)

AI-translated from Russian.

Location

In the root of the odpm project directory, file {platform_name}.conf. For the standard platform this is usually odoo.conf. The name depends on platform_name in odpm.json.

Why a file on disk when Odoo runs in a container

A developer or administrator edits configuration the usual way — a text file in the project directory. odpm does not require entering the container to change, for example, proxy_mode or log level.

On every environment prepare, odpm:

  1. Reads your file from disk.
  2. Substitutes database connection parameters from the service configuration.
  3. Recalculates addon paths (addons_path) and data directory (data_dir) as the process sees them inside the container (they differ from host paths).
  4. Writes the result to the service JSON (.odpm/runtime/config.json).
  5. On container start, the entrypoint creates the configuration file inside the container and passes Odoo -c with that path.

So the file in the project directory is your configuration interface; the container receives a consistent version with correct paths.

What you may edit manually

Parameters from Odoo documentation: proxy_mode, dbfilter, log_level, worker count, etc.

On a server reachable from the internet, proxy_mode and dbfilter are usually set together with a reverse proxy (nginx).

What odpm overwrites on prepare

  • addons_path — full list of addon paths inside the container;
  • data_dir — Odoo data directory inside the container;
  • db_host — synced with POSTGRES_SERVICE_NAME from .env (PostgreSQL service name in compose);
  • database placeholders in the template — real values from runtime.

If db_host on disk does not match POSTGRES_SERVICE_NAME, step template.odoo_conf recreates the config; odpm plan shows drift db_host_mismatch. See PostgreSQL state.

When the file is recreated entirely

If the file is missing, corrupted, or required database parameters are empty — odpm creates a template again.

After changes affecting paths or addon composition: odpm --skip-start and restart containers.

Image build scenario (ci)

The same configuration logic is baked into the image on odpm --build-image.