How-To Guides
Enable Odoo Enterprise

Enable Odoo Enterprise

Activate your Odoo Enterprise subscription on environments hosted with OEC.sh.


Overview

Odoo Enterprise is Odoo's paid version with additional features:

  • Studio (visual app builder)
  • Professional themes
  • Advanced inventory features
  • Full accounting with bank sync
  • HR & appraisals
  • Marketing automation
  • Mobile apps
  • And more...

OEC.sh + Enterprise: OEC.sh hosting is separate from your Odoo Enterprise subscription. You pay OEC.sh for hosting and Odoo SA for the Enterprise license.


Prerequisites

Before enabling Enterprise:

  • Odoo Enterprise subscription from odoo.com (opens in a new tab)
  • Enterprise subscription code (received via email from Odoo)
  • Admin access to your OEC.sh environment
  • Same Odoo version as your subscription

Step 1: Purchase Enterprise License

If you don't have an Enterprise license:

  1. Go to odoo.com/pricing-plan (opens in a new tab)
  2. Select Odoo Enterprise (not Online)
  3. Choose On-Premise deployment type
  4. Select your user count
  5. Complete the purchase
  6. Receive subscription code via email
⚠️

Important: Purchase the On-Premise license type, not the Online (SaaS) type. The Online license only works on odoo.com's servers.


Step 2: Add Enterprise Repository

Access Environment Settings

  1. Go to Environments in OEC.sh
  2. Click on your environment
  3. Go to the Repositories tab

Add Enterprise Addon Repository

  1. Click Add Repository
  2. Enter the Odoo Enterprise repository:
FieldValue
Repository URLhttps://github.com/odoo/enterprise.git
BranchYour Odoo version (e.g., 18.0, 17.0)
AuthenticationGitHub token with repo access

GitHub Access: You need a valid Odoo Enterprise subscription associated with your GitHub account to access the private enterprise repository.

Alternative: Use Odoo's Git Server

If you received credentials for Odoo's git server:

FieldValue
Repository URLhttps://github.com/odoo/enterprise.git
BranchYour Odoo version
UsernameYour Odoo portal email
PasswordYour Odoo portal password or GitHub token

Deploy Changes

  1. Click Save
  2. Click Deploy to pull the Enterprise modules

Step 3: Activate Subscription

Access Odoo Settings

  1. Log in to your Odoo instance as admin
  2. Go to Settings → General Settings
  3. Scroll to Odoo Enterprise Subscription

Enter Subscription Code

  1. Click Enter Subscription Code or Renew Subscription
  2. Enter your Enterprise subscription code
  3. Click Link Subscription

Verify Activation

After linking:

  • The Enterprise badge should appear
  • Enterprise apps become available in Apps menu
  • "Enterprise Edition" shows in the footer

Database UUID: Odoo links your subscription to your database UUID. If you clone or restore, you may need to re-link the subscription.


Step 4: Install Enterprise Apps

With Enterprise activated:

  1. Go to Apps
  2. Remove the "Apps" filter (search field)
  3. Search for Enterprise apps:
    • Studio
    • Social Marketing
    • Marketing Automation
    • Appraisals
    • Fleet
    • Helpdesk
    • Quality
    • And more...
  4. Click Install on desired apps

Verifying Your License

Check in Odoo

Go to Settings → General Settings → scroll to the subscription section:

StatusMeaning
LinkedSubscription is active and verified
ExpiringSubscription needs renewal
ExpiredNo valid subscription, Enterprise features disabled

Check via Database

In the terminal:

# Connect to database
docker exec -it YOUR_ENV_ID_db psql -U odoo YOUR_DATABASE
 
# Check subscription
SELECT key, value FROM ir_config_parameter
WHERE key IN ('database.enterprise_code', 'database.expiration_date');

Enterprise Features by Module

CategoryEnterprise Features
StudioVisual app builder, custom fields, automation
AccountingBank synchronization, asset management, budgets
InventoryBarcode, batch picking, wave picking
ManufacturingPLM, quality control, maintenance
HRAppraisals, fleet, referrals
MarketingSocial marketing, SMS, automation
ServicesHelpdesk, FSM, planning

Multi-Database Licensing

If you have multiple environments:

ScenarioLicense Requirement
Production + Staging (same org)Single license covers both
Production + Dev (same org)Single license covers both
Different clientsEach client needs own license
Clone for testingNo additional license needed
⚠️

Production Databases: Odoo counts production databases for licensing. Test/staging databases typically don't count, but verify with Odoo SA for your agreement.


Migrating Enterprise to OEC.sh

If you're migrating from another host with Enterprise:

  1. Export your database from the old host
  2. Import into OEC.sh (see Migration Guides)
  3. Add Enterprise repository (Step 2 above)
  4. Re-link subscription (Step 3 above)

Your subscription should recognize the database UUID and reactivate.


Common Issues

"Enterprise features not available"

Causes:

  1. Enterprise repository not added
  2. Subscription code not entered
  3. Subscription expired

Solutions:

  1. Verify repository in Repositories tab
  2. Re-enter subscription code in Settings
  3. Check expiration date with Odoo

"Repository access denied"

Cause: GitHub token doesn't have access to enterprise repo.

Solutions:

  1. Verify your Odoo subscription is linked to your GitHub account
  2. Request access at odoo.com/my/subscription (opens in a new tab)
  3. Create a new token with repo scope

"Module not found" for Enterprise app

Causes:

  1. Enterprise repository not pulled
  2. Wrong branch selected

Solutions:

  1. Redeploy the environment
  2. Verify repository branch matches Odoo version

Subscription Won't Link After Clone

Cause: Database UUID conflicts with original.

Solution:

  1. Go to terminal
  2. Clear the existing subscription:
    DELETE FROM ir_config_parameter
    WHERE key LIKE 'database.enterprise%';
  3. Re-enter subscription code

Removing Enterprise

If you want to revert to Community:

⚠️

Data Loss Warning: Some Enterprise apps store data in Enterprise-only tables. Removing Enterprise may result in data loss.

  1. Backup first - Create a full backup
  2. Uninstall Enterprise apps - Remove Enterprise-only modules
  3. Remove repository - Delete Enterprise repo from Repositories tab
  4. Redeploy - Deploy with only Community modules

Enterprise vs Community

FeatureCommunityEnterprise
Core apps (CRM, Sales, Inventory)YesYes
StudioNoYes
Marketing AutomationNoYes
Bank SynchronizationNoYes
Barcode AppNoYes
Quality ManagementNoYes
HelpdeskNoYes
Mobile AppsLimitedFull
Odoo SupportNoYes

Support

OEC.sh Support

For hosting and deployment issues:

Odoo Enterprise Support

For licensing and Enterprise features: