Back to all templates
Odoo logo

Odoo

Application2048MB+ RAM

All-in-one business management software

erpcrmbusinessall-in-one

Deploy Odoo in 3 Steps

1

Connect Your VPS

Add your server credentials to Server Compass

2

Select Odoo

Choose from our template library

3

Deploy & Configure

Fill in settings and click Deploy

No Docker knowledge required
Step-by-step deployment guide

Deploy Odoo on a VPS with Server Compass

Use the Odoo template in Server Compass to deploy a self-hosted business software suite with PostgreSQL on your VPS, then verify the Odoo web UI in a browser.

About 7 minutesBrowser verified
1
Step 1

Open the server Apps tab

Select the tutorial-vps VPS, open the Apps tab, and start a new app deployment. Keep sensitive server details hidden before capturing or sharing screenshots.

Server Compass Apps tab before creating an Odoo app
2
Step 2

Choose an app template

Click New App and choose the template deployment path so Server Compass can load the built-in catalog.

Choosing to deploy an app from a Server Compass template
3
Step 3

Search for Odoo

Use the template picker search to find Odoo in the Server Compass template catalog.

Searching for Odoo in the Server Compass template picker
4
Step 4

Select the Odoo template

Choose the Odoo template. Server Compass fills the Odoo image, PostgreSQL service, persistent site volumes, database settings, and required secret value.

Odoo template selected in Server Compass
5
Step 5

Review the Odoo settings

Confirm the app name and compose services. In this run, the app was named odoo-demo and used host port 8069.

Reviewing Odoo project settings and compose services
6
Step 6

Deploy Odoo

Review the generated environment values, keep the database password masked, confirm the port is available, and click Deploy Now.

Reviewing Odoo environment variables and port before deployment
7
Step 7

Watch the deployment progress

Keep the deployment modal open while Server Compass uploads the compose file, pulls the Odoo and PostgreSQL images, starts the containers, and verifies the stack.

Server Compass deploying the Odoo template on the VPS
8
Step 8

Confirm Odoo is running

After deployment finishes, return to the Apps tab and confirm the Odoo app is marked Running with its application URL available.

Odoo template running in the Server Compass Apps tab
9
Step 9

Open Odoo in the browser

Open the application URL in a browser. The Odoo database manager confirms the deployed app is reachable and ready for first-run database setup.

The deployed Odoo database manager loaded in a browser with generated secrets masked

After Odoo Opens

  • Complete the Odoo database setup with the generated PostgreSQL password from Server Compass.
  • Keep generated Odoo and database passwords masked in screenshots and docs.
  • Add a domain and HTTPS before inviting users or storing production data.
  • Install only the Odoo apps/modules needed for your workflow.
  • Back up both the Odoo application volume and the PostgreSQL data volume before production use.

Verified Result

The Odoo database manager loaded successfully in a browser after the container connected to PostgreSQL on port 5432.

Odoo deployment questions

What does the Odoo template deploy?

It deploys Odoo 17 with PostgreSQL 16 and persistent Odoo, add-ons, and database volumes.

Which port did the tutorial use?

The tutorial used host port 8069, which maps to the Odoo web server on container port 8069.

Why does the browser verification stop at the database manager?

A fresh Odoo deployment is considered reachable when the first-run database manager loads. Continuing further would require entering generated database credentials, so the public guide verifies the safe pre-install page with generated secrets masked.

Should this become a blog post?

No. The deployment guide should live on the Odoo template detail page and be linked from the reusable template deployment docs page.

Manual Setup Guide

Set Up Odoo from Terminal

Get your hands dirty: manual Odoo deployment guide for developers.

1

Establish SSH Connection

Connect to your remote server using SSH. Make sure you have your server credentials ready.

terminal
# Log into your server
ssh root@<your-server-ip>

# If using key-based auth
ssh -i ~/.ssh/my-key root@<your-server-ip>

First time? Docker not installed? Run: curl -fsSL https://get.docker.com | sh

2

Create Project Directory

Set up a directory to store your Docker configuration.

terminal
# Create and navigate to project directory
mkdir -p ~/apps/odoo
cd ~/apps/odoo
3

Configure Docker Compose

Add this configuration to your docker-compose.yml file:

docker-compose.yml
services:
  odoo:
    image: odoo:17
    ports:
      - "8069:8069"
    environment:
      - HOST=db
      - USER=odoo
      - PASSWORD=<your-db-password>
    volumes:
      - odoo_data:/var/lib/odoo
      - odoo_addons:/mnt/extra-addons
    restart: unless-stopped
    depends_on:
      db:
        condition: service_healthy

  db:
    image: postgres:16-alpine
    environment:
      - POSTGRES_USER=odoo
      - POSTGRES_PASSWORD=<your-db-password>
      - POSTGRES_DB=postgres
    volumes:
      - postgres_data:/var/lib/postgresql/data
    restart: unless-stopped
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U odoo"]
      interval: 10s
      timeout: 5s
      retries: 5

volumes:
  odoo_data:
  odoo_addons:
  postgres_data:
Environment Variables
PORTHost port(default: 8069)
DB_PASSWORDDatabase password
4

Start the Services

Execute the deployment and check the container status.

terminal
# Deploy the application
docker compose up -d

# Check container health
docker compose ps

# Monitor logs
docker compose logs -f --tail=100
5

Allow Incoming Connections

Enable network access by updating your firewall rules.

terminal
# Allow the application port through firewall
sudo ufw allow 8069/tcp
sudo ufw reload

# Access your app at:
# http://your-server-ip:8069
Skip the Terminal

Too complicated? Let Server Compass handle it.

Why type commands when you can click? Deploy Odoo the easy way with Server Compass.

  • Intuitive dashboard
  • Deploy in 3 minutes
  • Free SSL included
  • Blue-green deploys
  • Real-time logs
  • Version history
Download Server Compass$29 one-time • Lifetime license

After Deployment

After deploying Odoo with Server Compass, complete these steps to finish setup

1

Create database and admin user

2

Install required apps (CRM, Sales, etc.)

Need help? Check out our documentation for detailed guides.

Odoo FAQ

Common questions about self-hosting Odoo

How do I deploy Odoo with Server Compass?

Simply download Server Compass, connect to your VPS, and select Odoo from the templates list. Fill in the required configuration and click Deploy. The entire process takes under 3 minutes.

What are the system requirements for Odoo?

Odoo requires a minimum of 2048MB RAM. We recommend a VPS with at least 4096MB RAM for optimal performance. Any modern Linux server with Docker support will work.

Can I migrate my existing Odoo data?

Yes! Server Compass provides volume mapping that allows you to import existing data. You can also use standard Odoo backup and restore procedures.

How do I update Odoo to the latest version?

Server Compass makes updates easy. Simply click the Update button in your deployment dashboard, and the latest Odoo image will be pulled and deployed with zero downtime.

Is Odoo free to self-host?

Odoo is open-source software. You only pay for your VPS hosting (typically $5-20/month) and optionally Server Compass ($29 one-time). No subscription fees or per-seat pricing.

Ready to Self-Host Odoo?

Download Server Compass and deploy Odoo to your VPS in under 3 minutes. No Docker expertise required.

Download Server Compass