# Step-by-Step Guide for Installing Odoo with Docker Compose and Nginx

Step 1: Installing Docker Compose

To set up Odoo using Docker Compose, follow these steps:

1. **Update Your Package List:**
    
    ```bash
    sudo apt update
    ```
    
2. **Install Docker Compose:**
    
    ```bash
    sudo apt install docker-compose
    ```
    
    *Note: If you prefer a more recent Docker Compose package than the one included with Ubuntu 20.04, please refer to Step 1 of the guide titled "How To Install and Use Docker Compose on Ubuntu 20.04." If you choose to use this version, replace the "docker-compose" command with "docker-compose."*
    
3. **Verify the Installation:**
    
    ```bash
    docker-compose --version
    ```
    
    You should see output similar to this:
    
    ```bash
    docker-compose version 1.25.0, build unknown
    docker-py version: 4.1.0
    CPython version: 3.8.10
    ```
    
    Once Docker Compose is installed, proceed to the next step to configure and launch Odoo and PostgreSQL containers.
    

Step 2: Running Odoo and PostgreSQL with Docker Compose

To create Odoo and PostgreSQL containers, follow these steps:

1. **Create a Directory for Odoo Files:**
    
    ```bash
    mkdir ~/odoo
    cd ~/odoo
    ```
    
2. **Create a Docker Compose Configuration File:**
    
    ```bash
    nano docker-compose.yml
    ```
    
3. **Add the Following Content to "docker-compose.yml":**
    

```yaml
version: '3'
services:
  odoo:
    image: odoo:16.0
    env_file: .env
    depends_on:
      - postgres
    ports:
      - "127.0.0.1:8069:8069"
    volumes:
      - data:/var/lib/odoo
  postgres:
    image: postgres:15
    env_file: .env
    volumes:
      - db:/var/lib/postgresql/data/pgdata

volumes:
  data:
  db:
```

1. **Save and Exit the File.**
    
2. **Create an Environment File for Configuration:**
    
    ```bash
    nano .env
    ```
    
3. **Add the Following Content to ".env," Replacing the Highlighted Values with Your Desired Values:**
    

```yaml
# PostgreSQL environment variables
POSTGRES_DB=postgres
POSTGRES_PASSWORD=a_strong_password_for_user
POSTGRES_USER=odoo
PGDATA=/var/lib/postgresql/data/pgdata

# Odoo environment variables
HOST=postgres
USER=odoo
PASSWORD=a_strong_password_for_user
```

1. **Generate Strong Passwords for Odoo and PostgreSQL Using the openssl Command and Replace the "a\_strong\_password\_for\_user" Placeholders in the ".env" File.**
    
2. **Save and Exit the ".env" File.**
    
3. **Start the Odoo and PostgreSQL Containers in the Background:**
    
    ```bash
    docker-compose up -d
    ```
    
4. **Docker Compose Will Download the Necessary Docker Images and Start the Containers.**
    
5. **To Stop the Containers at Any Time, Run the Following Command in the "~/odoo" Directory:**
    
    ```bash
    docker-compose stop
    ```
    

With the containers running, you can test the Odoo server using the following curl command:

```bash
curl --head http://localhost:8069
```

This confirms that the Odoo server is operational. Next, proceed to set up Nginx for proxying public traffic to the Odoo container.

Step 3: Installing and Configuring Nginx

To configure Nginx for reverse proxying, follow these steps:

1. **Install Nginx and Allow Public Traffic to Ports 80 and 443:**
    
    ```bash
    sudo apt update
    sudo apt install nginx
    sudo ufw allow "Nginx Full"
    ```
    
2. **Create an Nginx Configuration File (e.g., "odoo.conf") in the "/etc/nginx/sites-available" Directory:**
    
    ```bash
    sudo nano /etc/nginx/sites-available/odoo.conf
    ```
    
3. **Add the Following Configuration to "odoo.conf," Replacing "your\_domain\_here" with Your Actual Domain Name:**
    

```nginx
server {
    listen       80;
    listen       [::]:80;
    server_name  your_domain_here;

    access_log  /var/log/nginx/odoo.access.log;
    error_log   /var/log/nginx/odoo.error.log;

    location / {
      proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
      proxy_set_header X-Real-IP $remote_addr;
      proxy_set_header X-Forwarded-Host $host;
      proxy_set_header X-Forwarded-Proto https;
      proxy_pass http://localhost:8069;
  }
}
```

1. **Save and Close the File.**
    
2. **Enable the Nginx Configuration by Creating a Symbolic Link in the "/etc/nginx/sites-enabled" Directory:**
    
    ```bash
    sudo ln -s /etc/nginx/sites-available/odoo.conf /etc/nginx/sites-enabled/
    ```
    
3. **Verify the Nginx Configuration:**
    
    ```bash
    sudo nginx -t
    ```
    
4. **Reload Nginx to Apply the New Configuration:**
    
    ```bash
    sudo systemctl reload nginx.service
    ```
    

Your Odoo site is now accessible over plain HTTP. Continue to the next step to secure the connection with TLS certificates using Certbot and Let's Encrypt.

Step 4: Installing Certbot and Setting Up TLS Certificates

To add TLS encryption to your Odoo site, follow these steps:

1. **Install Certbot and the Nginx Plugin:**
    
    ```bash
    sudo apt install certbot python3-certbot-nginx
    ```
    
2. **Run Certbot in --nginx Mode and Specify Your Domain:**
    
    ```bash
    sudo certbot --nginx -d your_domain_here
    ```
    
3. **Agree to the Let's Encrypt Terms, Enter Your Email Address, and Choose Whether to Redirect HTTP Traffic to HTTPS When Prompted.**
    
4. **Certbot Will Automatically Obtain and Configure Your SSL/TLS Certificate and Reload Nginx With the New Configuration.**
    
5. **Your Odoo Site Is Now Secure With HTTPS.**
    

Step 5: Setting Up Odoo

Reload your Odoo site via HTTPS in your web browser. You will be directed to Odoo's database configuration page, where you can enter the necessary information to complete the installation. Fill out the fields as follows:

* **Database Name:** odoo
    
* **Email:** Your email address
    
* **Password:** A strong and unique password for the administrator login
    
* **Demo data:** Check this option if it's your first Odoo installation
    

Click the "Create database" button, and Odoo will create its database tables. Afterward, you'll be redirected to the Odoo Apps administrative page. Keep a record of the email and password you chose, as they will be used to log in to Odoo in the future. Your Odoo installation is now complete and secured with TLS encryption.