docker-odoo-project

This repository does not build Odoo from scratch.

The base Odoo image is built and published from docker-odoo. This repository uses that prebuilt base image and builds a project-specific image on top of it with extra addons and Python dependencies.

How It Works

• odoo/Dockerfile is based on ghcr.io/gabbasovdinar/odoo-base:18.0-ce.
• odoo/addons.yml defines external addon repositories pulled into the image during build.
• local-addons/ contains project-specific local addons.
• odoo/requirements.txt contains extra Python dependencies for this project.
• docker-compose.yml runs the full stack: odoo, db, redis, kwkhtmltopdf, and caddy.

Repository Purpose

docker-odoo:

• builds the reusable base Odoo image;
• contains the shared Odoo infrastructure and base setup.

docker-odoo-project:

• uses a specific prebuilt base image;
• builds a project image on top of that base;
• pulls external addons via odoo/addons.yml;
• mounts local project modules via local-addons/.

The goal here is not to rebuild the platform itself, but to assemble and run a concrete project on top of an already prepared Odoo base.

Where To Make Changes

If you need to add external addon repositories:

• update odoo/addons.yml;
• rebuild the image with make build.

If you need to add local project modules:

• put them into local-addons/;
• then make up or make restart is usually enough if the image itself did not change.

If you need extra Python packages:

• update odoo/requirements.txt;
• rebuild with make rebuild-odoo.

Quick Start

cp .env.example .env
# fill in the required values in .env
make build
make up

If odoo/addons.yml contains private repositories, make sure GITHUB_TOKEN, GITLAB_TOKEN, or GIT_TOKEN is available before the build, depending on the git host you use.

Useful Commands

• make build - build the project Odoo image on top of the published base image
• make rebuild-odoo - rebuild the project image without cache
• make up - start the stack
• make down - stop the stack
• make logs - follow logs
• make sh - open a shell inside the odoo container
• make backup - create a database and filestore backup
• make restore BACKUP=backups/<name> - restore a backup

More Details

For detailed information about the base image, setup flow, image layering, project module layers, and the overall approach, see the main docker-odoo repository.