Odoo 19 Community – Local setup (macOS)

Run Odoo 19 Community on your Mac.

---

Option A: Run with Docker (easiest)

No Python or PostgreSQL needed on your machine.

Requirements: Docker Desktop for Mac.

cd /Users/yamenahmad/projects2026/odoo/odoo19
docker compose up -d

Open http://localhost:8069. First time: create a new database (name, email, password).

Test that it’s running:

./test_odoo.sh

Stop: docker compose down

---

Manual terminal guide (no scripts): see MANUAL-RUN.md for step-by-step commands only.

---

Option B: Run from source (venv + PostgreSQL)

Prerequisites

• macOS (Sonoma, Ventura, or Monterey)
• Homebrew – brew.sh – install with:

  /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  

• Xcode Command Line Tools (for compilers):

  xcode-select --install
  

1. Install PostgreSQL and wkhtmltopdf

brew install postgresql@15 wkhtmltopdf
brew services start postgresql@15

Create an Odoo database user (optional; you can also use your macOS user):

# Using your current user (no password by default on Mac)
createuser -s $(whoami)

# Or create a dedicated user with password:
createuser -s odoo
# Then in psql: ALTER USER odoo WITH PASSWORD 'odoo';

2. Run the setup script

From this directory:

chmod +x setup.sh
./setup.sh

This will:

• Clone Odoo 19.0 into ./odoo/
• Create a Python virtual environment in ./venv/
• Install Python dependencies from odoo/requirements.txt

3. Configure Odoo (optional)

Copy the example config and edit if needed:

cp odoo.conf.example odoo.conf

• db_user: your PostgreSQL user (e.g. your Mac username or odoo)
• db_password: leave empty if you use trust auth (typical on Mac)
• addons_path: defaults to odoo/addons (Community only)

4. Run Odoo

./run.sh

Or manually:

source venv/bin/activate
cd odoo && ./odoo-bin -c ../odoo.conf

• Open http://localhost:8069
• First run: create a new database (name, email, password, language)
• Default admin login after creating DB: email admin, password admin (if you use the demo setup)

Useful options

• Custom database name: ./odoo-bin -c odoo.conf -d mydb
• Development mode (auto-reload): add --dev=all to the command
• Install modules at start: -i sale,crm (comma-separated)

Troubleshooting

• Port 8069 in use: change xmlrpc_port in odoo.conf or run with --http-port=8070
• PostgreSQL connection refused: ensure it’s running: brew services start postgresql@15
• Python / pip errors: use Python 3.10, 3.11, or 3.12; create a fresh venv and run pip install -r odoo/requirements.txt again