How-To Guides
Migrate from Odoo Online

Migrate from Odoo Online (SaaS)

Move your Odoo Online (SaaS) database to OEC.sh for more control, customization, and cost savings.


Overview

Odoo Online (odoo.com SaaS) allows you to export your database, which you can then import into OEC.sh. This gives you:

  • Full customization - Install any module, modify code
  • Your own infrastructure - Choose your cloud provider
  • Cost control - Predictable pricing, no per-user fees
  • Data ownership - Your data on your servers
⚠️

Important: You cannot migrate from Odoo Online to a different Odoo version directly. Export is only available for the same version.


Prerequisites

Before starting:

  • Active Odoo Online subscription with admin access
  • OEC.sh account with a server configured
  • Sufficient disk space (2x your current database size)
  • Same Odoo version available in OEC.sh

Step 1: Export from Odoo Online

Access Database Manager

  1. Log in to your Odoo Online instance
  2. Go to https://YOUR-DATABASE.odoo.com/web/database/manager
  3. You may need your master password (set during initial setup)

Request Backup

  1. Find your database in the list
  2. Click Backup
  3. Select zip (includes filestore)
  4. Enter the master password if prompted
  5. Click Backup

Download the Backup

The download will start automatically. This may take several minutes for large databases.

The backup file will be named like: YOUR-DATABASE_YYYY-MM-DD_HH-MM-SS.zip

Large Databases: For databases over 5GB, the download may take considerable time. Ensure a stable internet connection.


Step 2: Upload to Cloud Storage

OEC.sh imports backups from cloud storage. Upload your backup to one of these providers:

Cloudflare R2:

  1. Log in to Cloudflare Dashboard
  2. Go to R2 Object Storage
  3. Create or select a bucket
  4. Upload your backup file
  5. Note the bucket name and file path

Step 3: Configure Storage Provider in OEC.sh

If you haven't already, add your storage provider to OEC.sh:

  1. Go to Settings → Storage Providers
  2. Click Add Storage Provider
  3. Select your provider type
  4. Enter credentials and bucket details
  5. Click Test Connection
  6. Save the configuration

Step 4: Create Migration in OEC.sh

Start Migration Wizard

  1. Go to Projects in the sidebar
  2. Click New Project
  3. Select Migrate from Backup

Configure Source

  1. Select your storage provider
  2. Browse to your uploaded backup file
  3. Click Validate Backup

OEC.sh will analyze the backup and detect:

  • Odoo version
  • Database size
  • Filestore size
  • Installed modules

Configure Target

  1. Project Name - Give your migrated project a name
  2. Odoo Version - Must match the backup version
  3. Server - Select where to deploy
  4. Resources - CPU, RAM, disk allocation

Review and Start

  1. Review the migration summary
  2. Click Start Migration

Step 5: Post-Migration Setup

After migration completes:

Update Base URL

  1. Go to your new Odoo environment
  2. Navigate to Settings → System Parameters
  3. Update web.base.url to your new domain

Configure Email

  1. Go to Settings → General Settings
  2. Set up outgoing mail server (SMTP)
  3. Test email sending

Update Integrations

If you have integrations (payment providers, shipping, etc.):

  1. Update API endpoints to your new domain
  2. Regenerate API keys if needed
  3. Test each integration

Custom Domain (Optional)

  1. Go to Environment → Domains
  2. Add your custom domain
  3. Configure DNS records
  4. SSL is provisioned automatically

Handling Enterprise Modules

⚠️

Odoo Enterprise: If your Odoo Online subscription includes Enterprise modules, you'll need a separate Odoo Enterprise subscription for your self-hosted instance. Contact Odoo for licensing options.

Enterprise modules in your backup will show as installed but may not function without a valid Enterprise subscription linked to your new instance.


Common Issues

"Backup format not recognized"

Cause: The backup may be in an older format or corrupted.

Solution:

  1. Re-download the backup from Odoo Online
  2. Verify the ZIP file opens correctly on your computer
  3. Ensure it contains dump.sql and filestore folder

Version Mismatch

Cause: Backup version doesn't match available OEC.sh version.

Solution:

  1. Check your Odoo Online version in the footer
  2. Select the matching version in OEC.sh
  3. If version not available, contact support

Missing Modules After Migration

Cause: Third-party or Enterprise modules may not be available.

Solution:

  1. Check module availability for your Odoo version
  2. Install required modules from OCA or other sources
  3. Add addon repositories in Project → Repositories

Large Database Timeout

Cause: Very large databases may timeout during restore.

Solution:

  1. Contact support for large database assistance
  2. Consider splitting the migration if possible

Verification Checklist

After migration, verify these items:

  • Admin login works
  • All users can log in
  • Data integrity (check key records)
  • Email sending works
  • Attachments and images display correctly
  • Custom reports generate properly
  • Integrations function correctly
  • Scheduled actions run on time

Canceling Odoo Online

Once you've verified everything works on OEC.sh:

  1. Keep Odoo Online active for at least 2 weeks as backup
  2. Verify all functionality in OEC.sh
  3. Export any final data if needed
  4. Cancel your Odoo Online subscription

Tip: Keep a final backup of your Odoo Online database before canceling, stored securely in your cloud storage.


Need Help?

For migration assistance:

  • Email: support@oec.sh
  • Include: Current Odoo Online URL, database size, any specific concerns