Odoo Bedrock container image

This image is meant as a greatest common denominator foundation to run Odoo.

It is a BYOO (bring-your-own-odoo) image, which means you need to create a derived image that adds your Odoo and addons. This image does not mandate any particular installation method for Odoo and addons, nor does it impose any constraint on your project structure.

Contents

• Available image tags
• Features exposed by these images
  • Configuration
• Examples
  • Installing addons and Odoo from source
• Credits
  • Contributors

Available image tags

The CI of this project builds regularly for some combinations of Odoo version, python version and Ubuntu version.

The supported combinations are visible in the [build matrix](./.github/workflows/ci.yml).

Features exposed by these images

Note

Anything not documented here considered implementation detail and may change.

• Ubuntu minimal because it's small and has recent pythons
• python, obviously, in an activated virtual environment.
• An entrypoint that generates the Odoo config file ($ODOO_RC) from environment variables (see the list of supported variables below).
• /usr/local/bin/wkhtmltopdf is the kwkhtmltopdf client. The default KWKHTMLTOPDF_SERVER_URL environment variable is set to http://kwkhtmltopdf.
• Odoo mandatory external dependencies (i.e. lessc for Odoo < 12)
• nano, less, for some rudimentary comfort when the time comes to investigate the container on the terminal
• postgres apt repo for easy installation of the latest postgres client tools if needed

Note Odoo's python dependencies are not included: you need to pip install Odoo's requirements.txt, or apt install them. This is not done in the base image as different projects may require different versions of these libraries.

Other dependencies are also notably absent (graphviz, antiword, poppler-utils), these being unused in the latest Odoo version and infrequently used in older versions.

The entrypoint does the following:

• Generate the $ODOO_RC file from environment variables
• If the command looks like odoo, run scripts in /odoo/start-entrypoint.d/.
• Unless $NOGOSU is set, run the entry point scripts, as well as the command, under user $LOCAL_USER_ID (defaults to 999).

For more details, read ./bin/entrypoint.sh.

Configuration

The following environment variables are used to generate the Odoo configuration file in $ODOO_RC:

• ADDITIONAL_ODOO_RC
• ADDONS_PATH
• ADMIN_PASSWD
• DB_FILTER
• DB_HOST
• DB_MAXCONN
• DB_NAME
• DB_PASSWORD
• DB_PORT
• DB_SSLMODE
• DB_TEMPLATE
• DB_USER
• LIMIT_MEMORY_HARD
• LIMIT_MEMORY_SOFT
• 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
• RUNNING_ENV
• SERVER_WIDE_MODULES (>=10)
• SYSLOG
• UNACCENT
• WITHOUT_DEMO
• WORKERS

The following environment variables are processed by the entrypoint, if the psql client is installed (which is not the case by default):

• 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.

Examples

These are typical Dockerfiles derived from this image, provided here for inspiration.

Installing addons and Odoo from source

Assume you have odoo source code in ./src/odoo and your addons in myaddons. You can create the following Dockerfile:

FROM ghcr.io/acsone/odoo-bedrock:14.0-py38-latest

COPY ./src/odoo /odoo/src/odoo
RUN \
  pip install --no-cache-dir \
    -r /odoo/src/odoo/requirements.txt \
    -f https://wheelhouse.acsone.eu/manylinux2014 \
  && pip install -e /odoo/src/odoo

COPY ./myaddons /odoo/myaddons

ENV ADDONS_PATH=/odoo/src/odoo/addons,/odoo/src/odoo/odoo/addons,/odoo/myaddons

Note:

• the use of -f https://wheelhouse.acsone.eu/manylinux2014 to find binary wheels that work without additional system dependencies. This is not mandadatory but helps having an image without build tools.
• for python2.7 Odoo versions (8.0, 9.0 and 10.0) please use -f https://wheelhouse.acsone.eu/manylinux1

Credits

Inspiration has been drawn from camptocamp/docker-odoo-project for most environment variables, the odoo config file templates, and entrypoint.sh. This is by design, in order to facilitate possible future convergence.

Contributors

• Stéphane Bidoul <stephane.bidoul@acsone.eu>