Deploy Your First Odoo Instance

Get a fully working Odoo instance running in under 10 minutes.

What You'll Need

• An OEC.SH account (sign up here (opens in a new tab))
• A server (your own VPS or use OEC.SH shared servers)
• Your Odoo code in a Git repository (GitHub, GitLab, or Bitbucket)

Step 1: Create Your Organization

1. Log in to OEC.SH
2. Click Create Organization
3. Enter your organization name (e.g., "My Agency" or "ACME Corp")
4. Click Create

Tip: Organizations are billing units. Create one per company or client.

Step 2: Add a Server

You can use OEC.SH shared servers or bring your own.

Option A: Use Shared Servers (Easiest)

Skip this step! Shared servers are automatically available for your environments.

Option B: Bring Your Own Server (Quick Connect)

The fastest way — one command sets up everything:

1. Go to Servers → Add Server → Quick Connect
2. Copy the install command
3. Run it on your server:

curl -sfL https://api.oec.sh/api/v1/install.sh | sudo OECSH_TOKEN=oecsh_reg_xxxx... bash

Docker, firewall, monitoring, and SSH keys are all installed automatically. Setup takes under 3 minutes.

Requirements: Ubuntu 20.04+ or Debian 11+, 2+ CPU cores, 4+ GB RAM, root access

Step 3: Connect Your Git Repository

1. Go to Settings → Git Connections
2. Click Add Connection
3. Choose your provider (GitHub, GitLab, or Bitbucket)
4. Authorize OEC.SH to access your repositories
5. Your repositories are now available for projects

Step 4: Create a Project

1. Go to Projects → Create Project
2. Fill in the details:
   • Name: Your project name (e.g., "Client ERP")
   • Git Repository: Select from connected repos
   • Odoo Version: Select your version (14.0 - 19.0)
3. Click Create Project

Step 5: Create an Environment

1. Open your project
2. Click Environments tab → Add Environment
3. Configure your environment:
   • Name: Auto-generated (e.g., client-erp-dev-1234)
   • Type: Development, Staging, or Production
   • Server: Choose your server
   • Resources:
     • CPU: 1-2 cores for dev, 2-4 for production
     • RAM: 2-4 GB for dev, 4-8 GB for production
     • Disk: 10-20 GB
4. Click Create Environment

Step 6: Deploy!

1. Open your environment
2. Click the Deploy button
3. Watch the deployment progress in real-time

Deployment typically takes 3-5 minutes. When complete, you'll see:

• Status: 🟢 Running
• Your Odoo URL (e.g., client-erp-dev-1234.apps.oec.sh)

Step 7: Access Your Odoo

1. Click the environment URL
2. Log in with default credentials:
   • Email: admin
   • Password: admin (change this immediately!)

Troubleshooting

Deployment Failed?

1. Check the Logs tab for error details
2. Common issues:
   • Git access denied: Reconnect your Git provider
   • Addon not found: Check your addons_path in config
   • Database error: Check PostgreSQL logs

Can't Access Odoo?

1. Verify status is 🟢 Running
2. Check if your browser is blocking the URL
3. Try a hard refresh (Ctrl+Shift+R)

Still stuck? Check our Troubleshooting Guide or contact support.