3e83d8d7d5
Includes: - Odoo 19 framework (odoo/) - 27 custom EnCoach addons (new_project/custom_addons/) - encoach_core, encoach_api, encoach_lms_api, encoach_adaptive_api - encoach_exam, encoach_taxonomy, encoach_adaptive, encoach_assignment - encoach_ai, encoach_ai_grading, encoach_ai_generation, encoach_ai_media - encoach_courseware, encoach_communication, encoach_subscription - encoach_notification, encoach_approval, encoach_branding - encoach_classroom, encoach_registration, encoach_stats - encoach_faq, encoach_ticket, encoach_training, encoach_resources - encoach_adaptive_ai, encoach_sis - 21 OpenEduCat Enterprise modules (new_project/enterprise-19/) - 14 OpenEduCat Community modules (new_project/openeducat_erp-19.0/) - Configuration: odoo.conf, requirements.txt, scripts - 200+ REST API endpoints with JWT authentication - SRS and test documentation Made-with: Cursor
120 lines
2.8 KiB
Markdown
120 lines
2.8 KiB
Markdown
# 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](https://www.docker.com/products/docker-desktop/) for Mac.
|
||
|
||
```bash
|
||
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:**
|
||
```bash
|
||
./test_odoo.sh
|
||
```
|
||
|
||
Stop: `docker compose down`
|
||
|
||
---
|
||
|
||
**Manual terminal guide (no scripts):** see **[MANUAL-RUN.md](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](https://brew.sh) – install with:
|
||
```bash
|
||
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
|
||
```
|
||
- **Xcode Command Line Tools** (for compilers):
|
||
```bash
|
||
xcode-select --install
|
||
```
|
||
|
||
## 1. Install PostgreSQL and wkhtmltopdf
|
||
|
||
```bash
|
||
brew install postgresql@15 wkhtmltopdf
|
||
brew services start postgresql@15
|
||
```
|
||
|
||
Create an Odoo database user (optional; you can also use your macOS user):
|
||
|
||
```bash
|
||
# 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:
|
||
|
||
```bash
|
||
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:
|
||
|
||
```bash
|
||
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
|
||
|
||
```bash
|
||
./run.sh
|
||
```
|
||
|
||
Or manually:
|
||
|
||
```bash
|
||
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
|