encoach_backend_new_v2/MANUAL-RUN.md

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:

# Xcode Command Line Tools (required for Python builds)
xcode-select --install

After that finishes:

# 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):

# 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

cd /Users/yamenahmad/projects2026/odoo/odoo19

---

3. Get Odoo 19 source (if not already there)

With git:

git clone https://github.com/odoo/odoo.git --branch 19.0 --depth 1 odoo

Or download ZIP (no git):

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

chmod +x odoo/odoo-bin

---

4. Create virtual environment and install dependencies

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

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:

cd /Users/yamenahmad/projects2026/odoo/odoo19
source venv/bin/activate
cd odoo
python odoo-bin -c ../odoo.conf

Without a config file (minimal):

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)

cd /Users/yamenahmad/projects2026/odoo/odoo19
source venv/bin/activate
cd odoo
python odoo-bin -c ../odoo.conf

Then open http://localhost:8069.