How to Install OCA Modules with Docker | The Odoo Community Association

If you're looking to deploy an Odoo server and integrate Odoo Community Association (OCA) modules, doing so via Docker offers a robust, efficient, and isolated solution. This method allows you to "containerize" your Odoo server, ensuring it operates within its own virtual environment without affecting other applications or services on your host machine. It's an ideal approach for both rapid prototyping and deploying full-scale production environments.

Setting up Odoo with Docker provides numerous benefits, including simplified deployment, consistent environments, and easy scalability. This guide outlines the fundamental steps for installing Odoo and integrating OCA modules using Docker and Docker Compose. While the instructions are tailored for Ubuntu, they can be easily adapted for macOS or Windows systems.

Prerequisites and Setup

Before proceeding with the installation, ensure you have Docker and Docker Compose installed on your system. These tools are essential for managing containerized applications.

1. Install Docker and Docker Compose:

   Ensure that Docker Engine and Docker Compose are installed on your operating system. Follow the official documentation for detailed installation instructions specific to your platform.

2. Create the Project Directory Structure:

   Begin by creating a dedicated directory for your Odoo project. For this guide, we'll assume the base installation directory is named odoo. Navigate into this directory and establish the necessary volume subdirectories to persist your PostgreSQL database, Odoo addons, filestore, and session data.

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

3. Configure Docker Compose File:

   Create a docker-compose.yml file within your odoo directory. This file defines the services, networks, and volumes for your multi-container Docker application. The configuration below sets up a PostgreSQL database service and an Odoo service, linking them appropriately and mapping necessary volumes for data persistence and addon integration. We are using elicocorp/odoo:10.0 as an example, and including the OCA business-requirement repository.

   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

Launching Odoo and Installing OCA Modules

4. Launch Your Odoo Container:

   From within your odoo directory, execute the following command to start the Odoo service defined in your docker-compose.yml file. The -d flag runs the containers in detached mode, allowing them to run in the background.

   docker-compose up -d odoo

5. Access Odoo in Your Browser:

   Once the containers are running, open your web browser and navigate to the URL specified in your docker-compose.yml file. In this particular example, the Odoo interface will be accessible at http://127.0.0.1:8069.

6. Create a New Odoo Database:

   Upon your first access, Odoo will prompt you to create a new database. Follow the on-screen instructions to set up your initial Odoo database instance.

7. Update Addons List:

   After creating the database, activate Odoo's developer mode. Then, navigate to the "Apps" menu and click on "Update Apps List" to ensure Odoo recognizes all newly added modules, including those from the OCA repository you configured.

8. Install Business Requirements Modules:

   Finally, return to the "Apps" menu. Search for and install the "Business Requirements" modules. These modules are now available thanks to the OCA repository linked in your Docker Compose configuration.

For more advanced configurations, such as adding custom parameters, changing default passwords, or integrating additional OCA repositories, refer to the detailed Odoo Docker documentation. This resource provides comprehensive guidance for optimizing your Odoo Docker environment for various use cases.