Setting Up Odoo on a Linux Server – Your Own Open Source ERP and CRM

Discover how to manage and automate business processes with Odoo's integrated ERP and CRM platform for smooth operations → Learn more now

10 November 20267 min read1 Views0 helpful

Introduction

Odoo is a modular open-source platform that combines Enterprise Resource Planning (ERP) and Customer Relationship Management (CRM) features. It enables businesses to centrally manage and automate processes such as accounting, inventory management, project management, and sales.

Thanks to flexible extensions, Odoo can be customized individually and offers an integrated solution to control all areas of a company.

Want to host this service yourself? We guide you step-by-step through the setup and configuration, showing you everything you need to know.

Setting Up Odoo on a Linux Server – Your Own Open Source ERP and CRM

Installing Odoo with One-Click Apps

You can install Odoo directly via One-Click Apps in the dashboard of your dedicated server. After the initial setup of the apps, open the app catalog, search for Odoo, and start the deployment with your preferred project, environment, and domain settings. This way, you can deploy and manage Odoo quickly and easily—without manual command line installation but with integrated web-based management, custom domain support, and SSL provisioning where available.

Requirements

Before installing Odoo, ensure your hosting environment meets the following minimum requirements to guarantee a smooth installation and optimal performance.

Hardware	Minimum	Recommended
CPU	1 vCPU core	4 vCPU cores
RAM	1 GB	4 GB
Disk space	15 GB	25 GB

The software requires all necessary dependencies and must run on a supported operating system. Before installation, check if your server meets the following requirements:

Dependencies: Docker

Operating System: Latest version of Ubuntu/Debian with Docker 26+

Make sure all dependencies are installed and the OS is up to date to avoid compatibility issues during Odoo installation.

Preparation

Before setting up Odoo, prepare your system. This includes updating the operating system to the latest version and installing all required dependencies. This ensures a stable environment and prevents problems during or after installation.

Update System

To run your system with the latest software and security updates, first perform an update by running:

Code

sudo apt update && sudo apt upgrade -y

This equips your system with the latest security patches and software versions before proceeding.

Install Dependencies

After the update, install the dependencies. Odoo runs via multiple Docker containers, so Docker must be installed first. Run the following commands:

Code

curl -fsSL https://get.docker.com -o get-docker.sh
sh get-docker.sh

A detailed guide on Docker installation and usage is available in our Docker tutorial.

Configure Domain

By default, Odoo runs on the host using ports 80 (HTTP) and 443 (HTTPS). Set up a domain with DNS entries pointing to your host. If your domain is managed with us, you can easily do this via the EasyDNS feature.

Installation

Once all requirements are met and preparations completed, you can start installing Odoo.

For multiple Docker projects, it’s advisable to create a clear directory structure to separate projects. A common approach is a docker folder in the user’s home directory with a subfolder per domain. This allows hosting multiple projects on one server without configuration conflicts.

For example, for the domain example.com:

Code

mkdir -p /docker/example.com
cd /docker/example.com

Inside this project folder, create subfolders that containers will mount as volumes. These volumes allow sharing or persistent storage of data between services. Especially important is the shared webroot, which both nginx and certbot need to access to create and renew SSL certificates. You can create a suitable structure like this:

Code

mkdir -p nginx/{conf,ssl,inc} config addons

This gives you dedicated folders for nginx configuration, SSL certificates, include files, and Odoo-specific content like configurations and addons.

Create Docker Compose

Create the file compose.yml in your Docker project with nano compose.yml and insert the following code:

Code

services:
  db:
    image: postgres:16
    ports:
      - "5432:5432"
    environment:
      - POSTGRES_USER=odoo
      - POSTGRES_PASSWORD=odoo
      - PGDATA=/var/lib/postgresql/data/pgdata
    volumes:
      - odoo-db-data:/var/lib/postgresql/data

  odoo:
    image: odoo:18.0
    depends_on:
      - db
    ports:
      - "8069:8069"
    volumes:
      - odoo-web-data:/var/lib/odoo
      - ./config:/etc/odoo
      - ./addons:/mnt/extra-addons
    command: odoo -d odoo_db -i base --db_user=odoo --db_password=odoo --db_host=db

  nginx:
    image: nginx:latest
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./nginx/conf:/etc/nginx/conf.d
      - ./nginx/inc:/etc/nginx/inc
      - ./nginx/ssl:/etc/nginx/ssl
      - ./nginx/certbot/www:/var/www/certbot
      - ./nginx/certbot/conf:/etc/letsencrypt
    depends_on:
      - odoo

  certbot:
    image: certbot/certbot
    volumes:
      - ./nginx/certbot/www:/var/www/certbot
      - ./nginx/certbot/conf:/etc/letsencrypt

volumes:
  odoo-db-data:
  odoo-web-data:

Configuration

Configure Nginx

Edit the nginx configuration file you created earlier and replace its content with the following configuration to ensure your site is accessible only via HTTPS.

Replace example.com in the server_name directive with your domain and adjust the paths to the certificate files in ssl_certificate and ssl_certificate_key accordingly.

bash

server {
    listen 443 ssl;
    http2 on;
    server_name example.com;

    
    include /etc/nginx/ssl/ssl.conf;

    
    ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;

    
    add_header X-Frame-Options  always;
    add_header Referrer-Policy  always;
    add_header Strict-Transport-Security  always;

    access_log /var/log/nginx/odoo_access.log;
    error_log  /var/log/nginx/odoo_error.log;

    
    include /etc/nginx/inc/gzip.conf;

    
    location / {
        proxy_pass http://odoo:8069;
        proxy_http_version 1.1;
        proxy_set_header Upgrade ;
        proxy_set_header Connection ;
        proxy_set_header Host ;
        proxy_cache_bypass ;
        proxy_set_header X-Real-IP ;
        proxy_set_header X-Forwarded-For ;
        proxy_set_header X-NginX-Proxy ;
        proxy_set_header X-Forwarded-Proto https;
        proxy_set_header X-Forwarded-Host ;
        proxy_redirect off;
        proxy_request_buffering off;
        
        proxy_connect_timeout 30s;
        proxy_send_timeout    60s;
        proxy_read_timeout    60s;
        send_timeout          60s;
    }

    
    location ~* /web/static/ {
        proxy_cache_valid 200 60m;
        proxy_buffering on;
        expires 864000;
        proxy_pass http://odoo:8069;
    }

    
    location /longpolling {
        proxy_pass http://odoo:8069;
        proxy_connect_timeout 60s;
        proxy_send_timeout    300s;
        proxy_read_timeout    300s;
        send_timeout          300s;
    }

    location /websocket {
        proxy_pass http://odoo:8069;
        proxy_http_version 1.1;
        proxy_set_header Upgrade ;
        proxy_set_header Connection ;
        proxy_set_header Host ;
        proxy_set_header X-Real-IP ;
        proxy_set_header X-Forwarded-For ;
        proxy_set_header X-Forwarded-Proto ;
    }
}

server {
    listen 80;
    server_name example.com;

    
    location /.well-known/acme-challenge/ {
        root /var/www/certbot;
    }

    location / {
         301 https://$host;
    }
}

Accessing the Website

After successful installation and configuration, and when all services are running, you can securely access your website by entering your domain in the browser address bar.

The homepage of your new installation will load. For the first login, there is a default account with username admin and password admin. It is strongly recommended to change these credentials immediately.

Conclusion and Further Resources

Congratulations! You have successfully installed and configured Odoo on your VPS/Dedicated Server. We also recommend checking out the following resources to help with further server configuration:

Odoo.com – Official website
odoo.com/documentation/18.0/ – Odoo documentation

Do you have specific questions not answered here? Our team is available daily for further help or support – just get in touch with us! 🙂

FAQ

Frequently asked questions

You can install Odoo directly via One-Click Apps in the dashboard of your dedicated server by searching for Odoo in the app catalog and starting deployment with your preferred project, environment, and domain settings.

Odoo is a modular open-source platform combining ERP and CRM features, allowing businesses to centrally manage processes like accounting, inventory, project management, and sales.

Minimum requirements are 1 vCPU core, 1 GB RAM, and 15 GB disk space. Recommended are 4 vCPU cores, 4 GB RAM, and 25 GB disk space.

Feedback

Was this article helpful?

Your feedback helps us prioritize and improve content.

0 of 0 Users found this article helpful.

Personal support

Need more help than the guide provides?

Our ZAP support team knows your product — briefly describe your issue and we'll help you personally.

Zappy knows this guide and answers you right in the chat.

server { listen 443 ssl; http2 on; server_name example.com; include /etc/nginx/ssl/ssl.conf; ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem; add_header X-Frame-Options always; add_header Referrer-Policy always; add_header Strict-Transport-Security always; access_log /var/log/nginx/odoo_access.log; error_log /var/log/nginx/odoo_error.log; include /etc/nginx/inc/gzip.conf; location / { proxy_pass http://odoo:8069; proxy_http_version 1.1; proxy_set_header Upgrade ; proxy_set_header Connection ; proxy_set_header Host ; proxy_cache_bypass ; proxy_set_header X-Real-IP ; proxy_set_header X-Forwarded-For ; proxy_set_header X-NginX-Proxy ; proxy_set_header X-Forwarded-Proto https; proxy_set_header X-Forwarded-Host ; proxy_redirect off; proxy_request_buffering off; proxy_connect_timeout 30s; proxy_send_timeout 60s; proxy_read_timeout 60s; send_timeout 60s; } location ~* /web/static/ { proxy_cache_valid 200 60m; proxy_buffering on; expires 864000; proxy_pass http://odoo:8069; } location /longpolling { proxy_pass http://odoo:8069; proxy_connect_timeout 60s; proxy_send_timeout 300s; proxy_read_timeout 300s; send_timeout 300s; } location /websocket { proxy_pass http://odoo:8069; proxy_http_version 1.1; proxy_set_header Upgrade ; proxy_set_header Connection ; proxy_set_header Host ; proxy_set_header X-Real-IP ; proxy_set_header X-Forwarded-For ; proxy_set_header X-Forwarded-Proto ; } } server { listen 80; server_name example.com; location /.well-known/acme-challenge/ { root /var/www/certbot; } location / { 301 https://$host; } }

Which 🍪 cookies would you like to allow?

Setting Up Odoo on a Linux Server – Your Own Open Source ERP and CRM

Introduction

Installing Odoo with One-Click Apps

Requirements

Preparation

Update System

Install Dependencies

Configure Domain

Installation

Create Docker Compose

Configuration

Configure Nginx

Accessing the Website

Conclusion and Further Resources

Frequently asked questions

Software

Installing Odoo with One-Click Apps

Preparation

Update System

Install Dependencies

Configure Domain

Accessing the Website

Conclusion and Further Resources

Game Server

Servers & Hosting

ZAPX

Resources

ZAP-Hosting

Installation

Create Docker Compose

Configuration

Configure Nginx

Firewall

Set Up Nginx

Create SSL Certificates

Odoo Configuration Options

Remove the -i base Flag