Odoo Build

This is the Mint System Odoo development environment.

This projects provides a highly opinionated way to manage and develop Odoo. It features:

• 🔍 Odoo Source: Checkout the Odoo Community and Enterprise Edition and start editing the source code.
• 🐳 Container Compose: Spin up an Odoo, Postgres, and pgAdmin container and experiment locally.
• 💻 Native: Start an Odoo server directly from the source.
• 🔄 Multiple Versions: With Odoo Build, you can switch between Odoo versions starting from 13.0 up to 18.0.
• 🛠️ Develop Modules: Scaffold new modules, develop new Odoo features locally.
• 📥 Import and Export Database: Use Odoo scripts to copy and restore a customer database to the local environment. Investigate issues and deploy the database with ease.
• 🤝 Community Repos: The most common community repos are checked out when setting up the project.
• ✂️ Customizing Snippets: Create snippets and push them to an Odoo database.
• 🕰️ Odoo Revisions: Snapshot the Odoo source at a specific date. See revisions for details.
• 📦 Container Image: Build and publish a custom Odoo images. See README for details.
• 🔑 Credentials: Manage login credentials for Odoo and Nextcloud.
• ⬆️ Odoo Upgrade: Helper commands to ease the Odoo upgrade process.
• 🧠 LLM: Start an MCP server and interact with Odoo through an LLM.
• 🚀 And More: See task help.

Requirements

The Odoo development environment has the following requirements:

• Docker or podman
• Install Python 3.12+ with uv: uv python install

MacOS

MacOS has the following additional requirements:

brew install grep gettext

Command Completion (Optional)

bash/zsh alias task='./task' with completion.

Nix (Optional)

You can use Nix to setup the requirements.

LLM (Optional)

Install the llm cli to make use of the LLM features.

Usage

The usage section is a set of workflows. See task help or task for details about the project commands.

Clone this repository.

git clone [email protected]:Mint-System/Odoo-Build.git
cd Odoo-Build

When working with Nix, run the nix-shell.

nix-shell

Checkout the Odoo version. Show supported versions with task list-versions.

task checkout "$VERSION"

Install build and Python dependencies. Currently supported: Arch Linux, Darwin, Debian, Fedora, Ubuntu, Pop!_OS, SteamOS, Windows with Ubuntu on WSL2.

task install

Decide wether you want to run Odoo in native mode (recommended) or as a container.

Run Odoo from source

Start database container only.

task start db

Initialize database.

task init-db

Start Odoo from source.

task start native

The browser will be opened automatically.

Run Odoo as container

Set the Odoo addons path in your .env file:

ODOO_ADDONS_PATH=/mnt/addons/,/mnt/oca/,/mnt/enterprise,/mnt/themes/

Run container compose.

task start

Initialize database with the image script.

task exec odoo init-db

Open browser to http://localhost:8069 and login with admin:admin.

Development

Create a new module from source

Create a new module.

task create-module addons/project/project_sprint

Add a new model.

task generate-module-model addons/project/project_sprint project.sprint

Add model security.

task generate-module-security addons/project/project_sprint project.sprint

Generate module docs.

task generate-module-docs addons/project/project_sprint project.sprint

Load modules from thirdparty folder

Clone thirdparty repos into the thirdparty folder.

To load modules from a thirdparty folder, set this env var in your .env file:

ODOO_ADDONS_PATH=thirdparty/odoo-apps-partner-contact,../odoo-cd/untracked-odoo-apps

The paths will be appended to the Odoo config.

Initialize without demo data

In your .env file set this env var:

ODOO_INIT_DEMO_DATA=False

Set Odoo database name

The default database name is the checked out Odoo version.

To define another name, set this env var in your .env file:

ODOO_DATABASE=odoo

Disable browser open

To disable the browser open when starting the Odoo server edit the .env file:

BROWSER_OPEN=false

Set podman as container engine

If you are using podman, set this .env var:

CONTAINER_ENGINE=podman

Change log level

To change the log level of Odoo set this env var in your .env file:

LOG_LEVEL=debug

Manage database with container

Start pgadmin.

task pgadmin

Open pgadmin http://localhost:8000/ and login with [email protected]:admin.

Remove containers

Removes containers and volumes.

task remove

Stop all containers

Without service name the stop commands stops all containers.

task stop

Drop database

To drop the default database run:

task drop-db

Define Postgres image version

Define the Postgres image in your .env file:

POSTGRES_IMAGE=postgres:16-alpine

Build and publish container image

Ensure the host machine can build multi-platform images.

Checkout latest revision of the Odoo version.

task checkout-latest-revision

Build and publish the Odoo image.

task build images/odoo --push

Setup mail catcher

Start mailpit server.

task start mailpit

When you send mails in Odoo they will be catched and shown on http://localhost:8025/.

Source env file

Assuming the name of the environment is test, you source env vars like this:

eval "$(task show-env test)"

Update the Odoo Upgrade script

Update the upgrade script:

wget https://upgrade.odoo.com/upgrade -O image/odoo-upgrade/bin/upgrade

Forward mails with Odoo Mailgate

Start all containers.

task start

Initialize the Odoo database.

task exec odoo init-db

Log into Odoo and setup an alias for [email protected].

Send a test mail with swaks:

swaks --to [email protected] --from [email protected] \
  --server localhost:25 \
  --body "This is a test email for the Odoo mailgate system." \
  --header "Subject: Test Email for Odoo"

The mail will be forwarded to Odoo.

Trace the mailgate log with:

docker exec mailgate tail -f /var/log/mail.log

You can also send a mail with tls encryption:

swaks --to [email protected] --from [email protected] \
  --server localhost:587 \
  --tls \
  --body "This is a test email for the Odoo mailgate system." \
  --header "Subject: Test Email for Odoo"

Create Odoo revision

Check the latest official Odoo image tag on https://hub.docker.com/_/odoo/tags.

Replace the - with a . in the tag name and create a revision:

task create-revision 18.0.20250520

Replace all image references in the docs.

Commit and push revision with tag:

task commit-and-push-revision

Update repo template from oca-addons-repo-template

Install copier.

source task source
uv pip install copier

Run copier and select ruff as linter.

copier copy --UNSAFE https://github.com/OCA/oca-addons-repo-template.git "templates/$VERSION"

Remove unnecessary linter files.

cd "templates/$VERSION"
rm -rf .github
rm .copier-answers.yml
rm .flake8
rm .isort.cfg
rm .pylintrc-mandatory
rm README.md

In .pre-commit-config.yaml remove mandatory pylint odoo:

  - id: pylint_odoo
    args:
      - --rcfile=.pylintrc-mandatory

In .pylintrc remove these rules:

• missing-return
• duplicate-xml-record-id
• redefined-builtin

In the .ruff.toml set this option:

line-length = 120

Template the server tools repo and run the linter:

task template-repo addons/server_tools
cd addons/server_tools
task all

Refine the templates based on the linter results.

Debug Odoo with VSCode.

In VSCode define a break point for a selected method.

Run Odoo native with a debugger.

task debug native

In VSCode run Python - attach debugger to attach the debugger.

Open http://localhost:8069 and run the method that you want to debug.

VSCode should jump to the breakpoint and you can step through the method.

Profile Odoo memory usage

Run Odoo with memray.

task record-with-memray native

Open http://localhost:8069 and finish the recording with ctrl+c.

The flamegraph report will be generated and opened.

Profile Odoo execution time

Run Odoo and get the process id.

PID=$(ps -eo pid,comm | grep -m 1 'odoo' | awk '{print $1}')

Record the Odoo process with py-spy.

task record-with-py-spy "$PID"

Finish the recording with ctrl+c.

The browser will open https://www.speedscope.app/. Upload the tmp/speedscope-profiling.json file.