dedicata/odoo repository overview

⁠dedicata/odoo

Versioned custom Odoo images for Dedicata, pinned to upstream Odoo commits and published to Docker Hub with stable aliases plus immutable release tags.

⁠Supported tags

⁠Versioning

• Each image is pinned to a specific upstream commit from the corresponding stable branch in odoo/odoo.
• Every publish also creates an immutable tag in the format X.Y-YYYYMMDD-<shortsha>, such as 19.0-20260406-7e5c738.
• Moving aliases like 19.0, 19, and latest are updated to the newest immutable tag of that line.
• The Docker build context is generated from the repository and committed, so the image source stays auditable.

⁠What is included

Besides the pinned upstream Odoo source, these images also pin:

• ghcr.io/acsone/odoo-bedrock as the base image
• odoo/design-themes
• OCA/server-auth
• OCA/server-tools/module_change_auto_install
• Dedicata addons for default Keycloak OIDC bootstrap and Run user provisioning
• itbrasil-odoo/themes

OCI labels are published with the source repository, image revision, base image digest, and the exact upstream commits used for Odoo, odoo/design-themes, OCA/server-auth, OCA/server-tools, and itbrasil-odoo/themes.

⁠Environment variables

This image inherits the runtime configuration mechanism from odoo-bedrock. These variables are used to generate $ODOO_RC at /etc/odoo.cfg.

Odoo options:

• ADDONS_PATH
• ADMIN_PASSWD
• DB_FILTER
• DB_HOST
• DB_REPLICA_HOST (>=18)
• DB_MAXCONN
• DB_MAXCONN_GEVENT (>=17)
• DB_NAME
• DB_PASSWORD
• DB_PORT
• DB_REPLICA_PORT (>=18)
• DB_SSLMODE
• DB_TEMPLATE
• DB_USER
• LIMIT_MEMORY_HARD
• LIMIT_MEMORY_HARD_GEVENT (>=18)
• LIMIT_MEMORY_SOFT
• LIMIT_MEMORY_SOFT_GEVENT (>=18)
• LIMIT_REQUEST
• LIMIT_TIME_CPU
• LIMIT_TIME_REAL
• LIMIT_TIME_REAL_CRON (>=11)
• LIST_DB
• LOG_DB
• LOG_HANDLER
• LOG_LEVEL
• LOGFILE
• MAX_CRON_THREADS
• SERVER_WIDE_MODULES (>=10)
• SYSLOG
• UNACCENT
• WITH_DEMO (>=19)
• WITHOUT_DEMO
• WORKERS

Other variables that affect $ODOO_RC:

• RUNNING_ENV: sets options.running_env for use by the OCA server_environment⁠ module.
• ADDITIONAL_ODOO_RC: appended verbatim at the end of $ODOO_RC.

Warning for Odoo 19:

• Starting with Odoo 19, running_env is no longer written into $ODOO_RC because it causes an Odoo warning and is redundant with the native environment variable support in server_environment.

Tip:

• Recent versions of server_environment support SERVER_ENV_CONFIG and SERVER_ENV_CONFIG_SECRET, which are usually better alternatives than ADDITIONAL_ODOO_RC.

The following environment variables are also processed by the entrypoint. In this image, psql is installed by default, and these hooks are applied when DB_NAME points to an existing and initialized database:

• ODOO_BASE_URL: sets the web.base.url system parameter and forces web.base.url.freeze to True.
• ODOO_REPORT_URL: sets the report.url system parameter.

Keycloak OIDC defaults:

• DEDICATA_KEYCLOAK_ISSUER_URL: Keycloak realm issuer URL, for example https://keycloak.example.com/realms/customer.
• DEDICATA_KEYCLOAK_CLIENT_ID: Odoo client ID in Keycloak.
• DEDICATA_KEYCLOAK_CLIENT_SECRET: Odoo client secret in Keycloak.
• DEDICATA_KEYCLOAK_ENABLED: optional; set to false, 0, no, or off to disable the provider.
• DEDICATA_KEYCLOAK_PROVIDER_NAME: optional; defaults to Keycloak.
• DEDICATA_KEYCLOAK_LOGIN_LABEL: optional; defaults to Login with Keycloak.
• DEDICATA_KEYCLOAK_SCOPE: optional; defaults to openid email profile.
• DEDICATA_KEYCLOAK_TOKEN_MAP: optional; defaults to sub:user_id email:email.
• DEDICATA_KEYCLOAK_LOCK_PROVIDER_CONFIG: optional; defaults to true and blocks UI/ORM edits to the managed provider fields.

Run identity provisioning defaults:

• DEDICATA_RUN_IDENTITY_BLOCK_OAUTH_AUTO_CREATE: optional; defaults to true and prevents SSO from creating users outside Run.
• DEDICATA_RUN_IDENTITY_DISABLE_PASSWORD_LOGIN: optional; defaults to true and blocks interactive password login when Keycloak is enabled.
• DEDICATA_RUN_IDENTITY_HIDE_PASSWORD_FORM: optional; defaults to true and hides the Odoo password form when Keycloak is enabled.
• DEDICATA_RUN_IDENTITY_LOCAL_LOGIN_ALLOWLIST: optional; defaults to admin.
• DEDICATA_RUN_IDENTITY_DEFAULT_GROUP_XMLIDS: optional; defaults to base.group_user.
• DEDICATA_RUN_IDENTITY_LOCK_USER_IDENTITY: optional; defaults to true and blocks UI/ORM edits to identity fields of users managed by Run.

New databases automatically install OCA auth_oidc, the Dedicata Keycloak bootstrap addon, and the Run identity provisioning addon. If the issuer URL or client ID is missing, the provider is kept disabled.

⁠Minimal usage

Pull the moving tag for a stable line:

docker pull dedicata/odoo:19.0

Pull an immutable image for a fully repeatable deployment:

docker pull dedicata/odoo:19.0-20260406-7e5c738

Use it as a base image in your own customization layer:

FROM dedicata/odoo:19.0

⁠Source and issues

• Source: https://github.com/Dedicata/odoo⁠
• Issues: https://github.com/Dedicata/odoo/issues⁠

⁠dedicata/odoo

Imagens customizadas versionadas do Odoo para a Dedicata, fixadas em commits upstream do Odoo e publicadas no Docker Hub com aliases estáveis e tags imutáveis.

⁠Tags suportadas

⁠Versionamento

• Cada imagem é fixada em um commit específico do branch estável correspondente em odoo/odoo.
• Cada publicação também cria uma tag imutável no formato X.Y-YYYYMMDD-<shortsha>, como 19.0-20260406-7e5c738.
• Aliases mutáveis como 19.0, 19 e latest são movidos para a tag imutável mais recente daquela linha.
• O contexto de build Docker é gerado a partir deste repositório e versionado no Git, mantendo a rastreabilidade da imagem.

⁠O que a imagem inclui

Além do código do Odoo fixado, estas imagens também fixam:

• ghcr.io/acsone/odoo-bedrock como imagem base
• odoo/design-themes
• OCA/server-auth
• OCA/server-tools/module_change_auto_install
• addons Dedicata para bootstrap padrao de OIDC com Keycloak e provisionamento de usuarios pelo Run
• itbrasil-odoo/themes

Labels OCI são publicadas com o repositório de origem, revisão da imagem, digest da imagem base e os commits exatos usados para o Odoo, odoo/design-themes, OCA/server-auth, OCA/server-tools e itbrasil-odoo/themes.

⁠Variáveis de ambiente

Esta imagem suporta o mesmo modelo de configuração herdado do odoo-bedrock, gerando o ODOO_RC a partir de variáveis de ambiente.

• A lista detalhada das opções suportadas está na seção Environment variables acima.
• RUNNING_ENV, ADDITIONAL_ODOO_RC, ODOO_BASE_URL e ODOO_REPORT_URL também são suportadas.
• As marcações >=17, >=18 e >=19 indicam em quais linhas de versão cada variável está disponível.
• Em Odoo 19, RUNNING_ENV continua suportada, mas running_env não é mais escrito no ODOO_RC.
• Novas bases instalam auth_oidc e os addons Dedicata automaticamente, criam o provider Keycloak a partir de DEDICATA_KEYCLOAK_ISSUER_URL, DEDICATA_KEYCLOAK_CLIENT_ID e DEDICATA_KEYCLOAK_CLIENT_SECRET, e expõem dedicata.run.identity para provisionamento via JSON-RPC.

⁠Uso mínimo

Baixe a tag mutável de uma linha estável:

docker pull dedicata/odoo:19.0

Baixe uma imagem imutável para um deploy totalmente reprodutível:

docker pull dedicata/odoo:19.0-20260406-7e5c738

Use a imagem como base da sua própria camada de customização:

FROM dedicata/odoo:19.0

⁠Código-fonte e issues

• Código-fonte: https://github.com/Dedicata/odoo⁠
• Issues: https://github.com/Dedicata/odoo/issues⁠