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

1. Go to Servers → Add Server
2. Enter your server details:
   • Name: A friendly name (e.g., "Production Server")
   • IP Address: Your server's public IP
   • SSH Port: Usually 22
   • SSH User: Usually root
   • Authentication: Password or SSH key
3. Click Test Connection to verify
4. Click Add Server

Requirements: Ubuntu 22.04+, 2+ CPU cores, 4+ GB RAM, Docker installed

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!)

What's Next?

• Add a Custom Domain - Use your own domain
• Set Up Backups - Protect your data
• Invite Team Members - Collaborate with your team

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.