Local Odoo Development Setup on Mac

This article provides a step-by-step guide to setting up a Local Odoo development environment on a Mac. Follow these instructions to ensure a smooth development experience.

Prerequisites

• Access to the Odoo repository you want to work with.

• Docker for Mac installed. Refer to the Docker documentation for installation: Docker Installation Guide.

• Homebrew installed. For installation details, visit: Homebrew Homepage.

Clone the Odoo Repository

Clone the Odoo repository you want to work with. Execute the following command in your terminal:

git clone <github url>

Replace  with the actual URL of the Odoo repository you want to work on locally.

Install Zodoo

Zodoo is a lightweight Docker Framework for Odoo. Install Zodoo using Bash:

bash <(curl -fsSL https://raw.githubusercontent.com/Odoo-Ninjas/zodoo/refs/heads/main/install.sh)

Configure Odoo Development Settings

Navigate to the cloned Odoo repository in your IDE. Open the terminal and set up the Odoo development environment:

odoo setting DEVMODE 1

odoo setting ODOO_DEMO 1

odoo reload

odoo build

To reset the database for demo purposes, use:

odoo -f db reset

If you need to restore a customer database, use:

odoo -f restore odoo-db

odoo update

Problems that might occur

If you are encountering issues due to a previous installation of Wodoo (📦 Installing /Users/David/.odoo/images/wodoo/src via pipx... Unable to parse package spec: /Users/.odoo/images/wodoo/src), run the following command to clean up:

rm -Rf ~/.odoo/images

If you receive an error related to syncing folders (File "/Users/.odoo/images/wodoo/src/wodoo/tools.py", line 1153, in rsync_progress_param version = tuple(map(int, match.groups())) ^^^^^^^^^^^^ AttributeError: 'NoneType' object has no attribute 'groups')
first install rsync:

brew install rsync

To set the Python version, use the following command:

odoo setting ODOO_PYTHON_VERSION 3.12

Conclusion

By following these steps, you should have a fully functioning Local Odoo development setup on your Mac. Ensure you update the necessary settings and installations as described to maintain smooth operations in your Odoo environment.