How to Install OCA Modules with Odoo and Docker

For those looking to deploy an Odoo server efficiently, leveraging Docker offers a robust and streamlined solution. This method allows you to containerize your Odoo instance, ensuring it operates within an isolated virtual environment without affecting other services on your host machine. This guide will walk you through setting up Odoo with Docker and installing modules from the Odoo Community Association (OCA), making it ideal for both quick tests and full production deployments.

Prerequisites

Before proceeding with the Odoo installation, ensure you have the necessary tools installed on your system. This guide is based on Ubuntu OS, but the steps are easily adaptable for macOS or Windows environments.

1. Install Docker and Docker Compose: Begin by installing Docker Engine and Docker Compose on your system. These tools are fundamental for managing containerized applications.

Step-by-Step Odoo and OCA Module Installation

Follow these detailed steps to set up your Odoo environment and integrate OCA modules.

2. Create the Directory Structure: Establish the foundational directory structure for your Odoo project. We will assume the base installation directory is named odoo.

   mkdir odoo && cd odoo
   mkdir -p ./volumes/postgres ./volumes/odoo/addons ./volumes/odoo/filestore \
   ./volumes/odoo/sessions

   This structure organizes your PostgreSQL data, Odoo addons, filestore, and session data within dedicated volumes, ensuring data persistence and clean separation.

3. Configure docker-compose.yml: Create a docker-compose.yml file in your odoo directory. This file defines the services, networks, and volumes for your multi-container Docker application. Below is an example configuration that includes a PostgreSQL database and an Odoo instance, configured to fetch OCA modules.

   version: '3.3'
   services:
     postgres:
       image: postgres:9.5
       volumes:
         - ./volumes/postgres:/var/lib/postgresql/data
       environment:
         - POSTGRES_USER=odoo
     odoo:
       image: elicocorp/odoo:10.0
       command: start
       ports:
         - 127.0.0.1:8069:8069
       volumes:
         - ./volumes/odoo/addons:/opt/odoo/additional_addons
         - ./volumes/odoo/filestore:/opt/odoo/data/filestore
         - ./volumes/odoo/sessions:/opt/odoo/data/sessions
       links:
         - postgres:db
       environment:
         - ADDONS_REPO=https://github.com/OCA/business-requirement.git
         - ODOO_DB_USER=odoo

   This configuration specifies a PostgreSQL 9.5 image for the database and an Odoo 10.0 image. It maps local volumes to container paths for data persistence and sets environment variables, including ADDONS_REPO to automatically clone the desired OCA module repository.

4. Launch Your Odoo Container: From within your odoo directory, execute the following command to start your Odoo and PostgreSQL containers in detached mode.

   docker-compose up -d odoo

   The -d flag ensures the containers run in the background, allowing you to continue using your terminal. This command will bring up the Odoo service along with its linked PostgreSQL database.

5. Access Odoo via Web Browser: Once the containers are running, open your web browser and navigate to the URL specified in your docker-compose.yml file. In this example, it's http://127.0.0.1:8069.

6. Create a New Database: Upon accessing the Odoo interface for the first time, you will be prompted to create a new database. Provide the necessary details to set up your Odoo instance.

7. Update Addons List: After creating your database, activate developer mode in Odoo (usually found at the bottom of the settings page). Then, navigate to the Apps menu and click on Update Apps List to ensure all newly added modules from the OCA repository are recognized.

8. Install OCA Modules: With the addons list updated, return to the Apps menu. Search for and install the specific OCA modules you require, such as the Business Requirements module in this example.

Further Customization and Improvement

To further enhance and customize your Odoo Docker environment, including adding additional parameters or modifying default passwords for enhanced security, refer to the comprehensive documentation available at the Elico-Corp Odoo Docker repository. This resource provides valuable insights for optimizing your setup for various use cases.

By following these steps, you can efficiently deploy an Odoo instance with Docker and seamlessly integrate powerful OCA modules, streamlining your business operations and development workflows.