# 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**.