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...

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. Choose Self-Hosted as the hosting option (this is the deployment type that lets you run Odoo on your own infrastructure, including OEC.sh). Odoo recently renamed this from "On-Premise" to "Self-Hosted", they refer to the same thing.
3. Select your user count and apps
4. Complete the purchase
5. Receive your subscription code via email

Step 2: Get GitHub Access to Odoo Enterprise

This is the step that breaks most installs. Two substeps, in order.

2a: Link your GitHub user to your Odoo subscription

Odoo only grants access to odoo/enterprise to GitHub usernames you have explicitly linked to an active subscription. Until you do this, no PAT will work — GitHub will return a 404 on the repo because your account cannot see it.

2b: Generate a GitHub Personal Access Token

Once the 404 test passes, generate a PAT that OEC.sh will use to clone odoo/enterprise on each deploy.

Step 3: Add the PAT as a Git Connection on OEC.sh

Step 4: Add the Enterprise Repository

Step 5: Select the Repository on Your Project

1. Open your Project in OEC.sh
2. Click the Repositories tab
3. Find the newly-created Odoo Enterprise entry under Organization-level addons
4. Tick it so it applies to this project
5. Save

Step 6: Redeploy

Go to your Environment and click Deploy. The platform will:

1. Clone odoo/enterprise.git at the branch you picked into /mnt/extra-addons/enterprise/ on your server
2. Restart the Odoo container with the new addons path
3. Make Enterprise modules installable from the Apps menu

Wait for the deployment to complete. The UI will flip to the Enterprise theme once web_enterprise is loaded.

Step 7: Activate the Enterprise Subscription Code

Step 8: 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:

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

Multi-Database Licensing

If you have multiple environments:

Migrating Enterprise to OEC.sh

If you're migrating from another host (Odoo SH, self-hosted, etc.) with Enterprise already in use:

1. Export your database from the old host and import into OEC.sh (Migration Guides)
2. Run through Steps 2–6 above to register the Enterprise repo on OEC.sh and deploy it
3. Re-link the subscription in Odoo (Step 7) — the database UUID is preserved across migration so the subscription usually recognises it on first link

If the Odoo UI looks like Community after the migration import, that's expected until Steps 2–6 are complete. The database has the modules marked installed, but the Enterprise source code is not yet on your OEC.sh server.

Common Issues

"Repository not found" or "Write access denied" at deploy time

This is almost always a GitHub access problem, not a code problem. Check in this order:

1. GitHub user not linked to Odoo subscription. Open https://github.com/odoo/enterprise from your GitHub account. If it's a 404, go back to Step 2a.
2. PAT is missing the repo scope. Regenerate the token with repo ticked (Step 2b) and update the git connection on OEC.sh.
3. You used OAuth instead of a PAT. OAuth does not work for odoo/enterprise. Create a PAT (Step 2b) and use it as the git connection.
4. Wrong branch in the addon repo. The default main does not exist on odoo/enterprise. Set the branch to match your Odoo major version (19.0, 18.0, 17.0, etc.).

"Enterprise features not available" inside Odoo

Causes:

1. Enterprise repository not selected on the project
2. Subscription code not entered
3. Subscription expired

Solutions:

1. Verify the repo is ticked on your project's Repositories tab
2. Re-enter the subscription code in Settings
3. Check expiration date with Odoo

"Module not found" for an Enterprise app

Causes:

1. Enterprise repository didn't clone on the last deploy (see the deploy-time errors section above)
2. Wrong branch selected — module exists on 19.0 but you cloned 18.0 or vice versa

Solutions:

1. Redeploy after fixing the underlying access / branch issue
2. Verify the repository branch matches your Odoo version

Subscription Won't Link After Clone

Cause: Database UUID conflicts with the original.

Solution:

1. Connect via docker exec as described in the verification section

2. Clear the existing subscription entries:

   DELETE FROM ir_config_parameter
   WHERE key LIKE 'database.enterprise%';

3. Re-enter the subscription code in Odoo's Settings

Removing Enterprise

If you want to revert to Community:

1. Backup first — Create a full backup
2. Uninstall Enterprise apps — Remove Enterprise-only modules from Odoo's Apps menu
3. Remove repository — Untick the Odoo Enterprise entry on your project's Repositories tab
4. Redeploy — Deploy with only Community modules

Enterprise vs Community

Support

OEC.sh Support

For hosting, deployment, and git-connection issues:

• Email: support@oec.sh

Odoo Enterprise Support

For licensing, GitHub access, and Enterprise features themselves:

• Portal: odoo.com/my/tickets (opens in a new tab)
• Email: Your assigned Odoo account manager