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
166 lines
3.5 KiB
Markdown
166 lines
3.5 KiB
Markdown
# Run Odoo 19 manually from the terminal
|
||
|
||
Step-by-step terminal commands. No scripts—run each block yourself.
|
||
|
||
---
|
||
|
||
## 1. Install prerequisites (one-time)
|
||
|
||
Open **Terminal** and run:
|
||
|
||
```bash
|
||
# Xcode Command Line Tools (required for Python builds)
|
||
xcode-select --install
|
||
```
|
||
|
||
After that finishes:
|
||
|
||
```bash
|
||
# Homebrew (if you don’t have it)
|
||
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
|
||
|
||
# PostgreSQL and wkhtmltopdf
|
||
brew install postgresql@15 wkhtmltopdf
|
||
|
||
# Start PostgreSQL
|
||
brew services start postgresql@15
|
||
```
|
||
|
||
Create a PostgreSQL user (pick one):
|
||
|
||
```bash
|
||
# Option A: use your Mac username (no password)
|
||
createuser -s $(whoami)
|
||
|
||
# Option B: create user "odoo" with password (then set password in step 2)
|
||
createuser -s odoo
|
||
```
|
||
|
||
---
|
||
|
||
## 2. Go to your project folder
|
||
|
||
```bash
|
||
cd /Users/yamenahmad/projects2026/odoo/odoo19
|
||
```
|
||
|
||
---
|
||
|
||
## 3. Get Odoo 19 source (if not already there)
|
||
|
||
**With git:**
|
||
|
||
```bash
|
||
git clone https://github.com/odoo/odoo.git --branch 19.0 --depth 1 odoo
|
||
```
|
||
|
||
**Or download ZIP (no git):**
|
||
|
||
```bash
|
||
curl -sL "https://github.com/odoo/odoo/archive/refs/heads/19.0.zip" -o odoo-19.0.zip
|
||
unzip -q odoo-19.0.zip
|
||
mv odoo-19.0 odoo
|
||
rm odoo-19.0.zip
|
||
```
|
||
|
||
```bash
|
||
chmod +x odoo/odoo-bin
|
||
```
|
||
|
||
---
|
||
|
||
## 4. Create virtual environment and install dependencies
|
||
|
||
```bash
|
||
cd /Users/yamenahmad/projects2026/odoo/odoo19
|
||
|
||
python3 -m venv venv
|
||
source venv/bin/activate
|
||
|
||
pip install --upgrade pip wheel setuptools
|
||
pip install -r odoo/requirements.txt
|
||
```
|
||
|
||
Leave the terminal open; keep the venv activated for the next steps.
|
||
|
||
---
|
||
|
||
## 5. (Optional) Config file
|
||
|
||
```bash
|
||
cp odoo.conf.example odoo.conf
|
||
```
|
||
|
||
Edit `odoo.conf` if needed:
|
||
|
||
- **db_user** = your PostgreSQL user (e.g. your Mac username or `odoo`)
|
||
- **db_password** = leave empty for trust auth, or set if you gave `odoo` a password
|
||
- **addons_path** = `addons` (default; add more paths comma-separated if you have extra addons)
|
||
|
||
If you don’t create `odoo.conf`, you can pass everything on the command line in step 6.
|
||
|
||
---
|
||
|
||
## 6. Run Odoo from the terminal
|
||
|
||
From `/Users/yamenahmad/projects2026/odoo/odoo19`, with venv **activated**:
|
||
|
||
```bash
|
||
cd /Users/yamenahmad/projects2026/odoo/odoo19
|
||
source venv/bin/activate
|
||
cd odoo
|
||
python odoo-bin -c ../odoo.conf
|
||
```
|
||
|
||
**Without a config file** (minimal):
|
||
|
||
```bash
|
||
cd /Users/yamenahmad/projects2026/odoo/odoo19
|
||
source venv/bin/activate
|
||
cd odoo
|
||
python odoo-bin --addons-path=addons
|
||
```
|
||
|
||
You should see logs in the terminal. When you see something like “HTTP service (HTTP) listening on 0.0.0.0:8069”, Odoo is ready.
|
||
|
||
---
|
||
|
||
## 7. Open in browser
|
||
|
||
- Go to: **http://localhost:8069**
|
||
- First time: create a new database (name, email, password, language)
|
||
- Then log in with the email and password you set
|
||
|
||
---
|
||
|
||
## Useful command-line options
|
||
|
||
Run from inside the `odoo` folder with venv activated:
|
||
|
||
| What you want | Command |
|
||
|----------------------------|--------|
|
||
| Use a specific database | `python odoo-bin -c ../odoo.conf -d mydb` |
|
||
| Different port | `python odoo-bin -c ../odoo.conf --http-port=8070` |
|
||
| Auto-reload (development) | `python odoo-bin -c ../odoo.conf --dev=all` |
|
||
| Install modules at start | `python odoo-bin -c ../odoo.conf -d mydb -i sale,crm` |
|
||
| Extra addons path | `python odoo-bin --addons-path=addons,/path/to/extra/addons` |
|
||
|
||
---
|
||
|
||
## Stop Odoo
|
||
|
||
In the terminal where Odoo is running: press **Ctrl+C**.
|
||
|
||
---
|
||
|
||
## Quick reference (after first setup)
|
||
|
||
```bash
|
||
cd /Users/yamenahmad/projects2026/odoo/odoo19
|
||
source venv/bin/activate
|
||
cd odoo
|
||
python odoo-bin -c ../odoo.conf
|
||
```
|
||
|
||
Then open **http://localhost:8069**.
|