# jcmontoyadev/odoo-docker-plus architecture

> Architecture diagram of the GitHub repository jcmontoyadev/odoo-docker-plus, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jcmontoyadev/odoo-docker-plus
- Repository: https://github.com/jcmontoyadev/odoo-docker-plus

## Overview

odoo-docker-plus is a Docker Compose template for running Odoo 20 with PostgreSQL, ready-made configuration, and optional user-supplied modules and dependencies. The main workflow is to start the Compose stack, then open Odoo in a browser and create a database. The README also documents nightly builds and Paper Muncher support. Source excerpts are limited to the dependency list, so relationships below rely on the README; implementation details in the Compose and Docker files are not independently verified.

Main entry points: [`compose.yaml`](https://github.com/jcmontoyadev/odoo-docker-plus/blob/main/compose.yaml) (Compose stack), [`Dockerfile`](https://github.com/jcmontoyadev/odoo-docker-plus/blob/main/Dockerfile) (Odoo image build), [`custom_addons`](https://github.com/jcmontoyadev/odoo-docker-plus/tree/main/custom_addons) (Custom addons), [`config/odoo.conf`](https://github.com/jcmontoyadev/odoo-docker-plus/blob/main/config/odoo.conf) (Odoo config)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_deployment["Deployment setup"]
  node_compose["Compose stack<br/>[compose.yaml]"]
  node_image["Odoo image build"]
  node_odoo_config["Odoo config<br/>[odoo.conf]"]
end

subgraph group_runtime["Odoo runtime"]
  node_odoo["Odoo 20"]
  node_postgres[("PostgreSQL")]
  node_browser["Browser UI"]
end

subgraph group_extensions["Customization"]
  node_custom_addons["Custom addons"]
  node_python_deps["Python dependencies<br/>[requirements.txt]"]
  node_system_deps["System dependencies<br/>[compose.yaml]"]
  node_paper_muncher["Paper Muncher"]
end

node_operator(("Operator"))

node_operator -->|"starts stack"| node_compose
node_compose -->|"builds image"| node_image
node_compose -->|"runs service"| node_odoo
node_compose -->|"runs service"| node_postgres
node_compose -->|"mounts config"| node_odoo_config
node_compose -->|"mounts addons"| node_custom_addons
node_compose -->|"configures packages"| node_system_deps
node_image -->|"installs packages"| node_python_deps
node_image -->|"installs engine"| node_paper_muncher
node_operator -->|"opens Odoo"| node_browser
node_browser -->|"uses web UI"| node_odoo
node_odoo -->|"uses database"| node_postgres
node_odoo -->|"loads modules"| node_custom_addons

click node_compose "https://github.com/jcmontoyadev/odoo-docker-plus/blob/main/compose.yaml"
click node_image "https://github.com/jcmontoyadev/odoo-docker-plus/blob/main/Dockerfile"
click node_odoo_config "https://github.com/jcmontoyadev/odoo-docker-plus/blob/main/config/odoo.conf"
click node_custom_addons "https://github.com/jcmontoyadev/odoo-docker-plus/tree/main/custom_addons"
click node_python_deps "https://github.com/jcmontoyadev/odoo-docker-plus/blob/main/requirements.txt"
click node_system_deps "https://github.com/jcmontoyadev/odoo-docker-plus/blob/main/compose.yaml"
click node_paper_muncher "https://github.com/jcmontoyadev/odoo-docker-plus/blob/main/Dockerfile"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_compose,node_image,node_odoo_config toneBlue
class node_odoo,node_postgres,node_browser toneAmber
class node_custom_addons,node_python_deps,node_system_deps,node_paper_muncher toneMint
class node_operator toneIndigo
```

## Components

### Deployment setup

- [Compose stack](https://github.com/jcmontoyadev/odoo-docker-plus/blob/main/compose.yaml): `compose.yaml`
- [Odoo image build](https://github.com/jcmontoyadev/odoo-docker-plus/blob/main/Dockerfile): `Dockerfile`
- [Odoo config](https://github.com/jcmontoyadev/odoo-docker-plus/blob/main/config/odoo.conf): `config/odoo.conf`

### Odoo runtime

- **Odoo 20**
- **PostgreSQL**
- **Browser UI**

### Customization

- [Custom addons](https://github.com/jcmontoyadev/odoo-docker-plus/tree/main/custom_addons): `custom_addons`
- [Python dependencies](https://github.com/jcmontoyadev/odoo-docker-plus/blob/main/requirements.txt): `requirements.txt`
- [System dependencies](https://github.com/jcmontoyadev/odoo-docker-plus/blob/main/compose.yaml): `compose.yaml`
- [Paper Muncher](https://github.com/jcmontoyadev/odoo-docker-plus/blob/main/Dockerfile): `Dockerfile`

### Other components

- **Operator**

## Connections

- Operator → Compose stack: starts stack (evidence: `README.md`)
- Compose stack → Odoo image build: builds image (evidence: `README.md`)
- Compose stack → Odoo 20: runs service (evidence: `README.md`)
- Compose stack → PostgreSQL: runs service (evidence: `README.md`)
- Compose stack → Odoo config: mounts config (evidence: `README.md`)
- Compose stack → Custom addons: mounts addons (evidence: `README.md`)
- Compose stack → System dependencies: configures packages (evidence: `README.md`)
- Odoo image build → Python dependencies: installs packages (evidence: `README.md`)
- Odoo image build → Paper Muncher: installs engine (evidence: `README.md`)
- Operator → Browser UI: opens Odoo (evidence: `README.md`)
- Browser UI → Odoo 20: uses web UI (evidence: `README.md`)
- Odoo 20 → PostgreSQL: uses database (evidence: `README.md`)
- Odoo 20 → Custom addons: loads modules (evidence: `README.md`)
