Product Guide
Migration
Overview

Migrations

Move your Odoo instance to OEC.sh from Odoo.sh, Odoo Online, on-premise servers, or other hosting platforms. Your complete database, file attachments, custom modules, and user accounts all come with you.

Odoo 13.0 through 19.0 are supported. Your version is detected automatically from the backup.


Supported Sources

SourceDescription
Odoo.shOfficial Odoo cloud platform
Odoo OnlineOdoo SaaS offering
On-PremiseSelf-hosted Odoo installations
Other PaaSOther hosting platforms

Step 1: Export Your Backup

From Odoo.sh

  1. Log in to odoo.sh (opens in a new tab)
  2. Select your project and go to the production branch
  3. Click the Backups tab
  4. Click Create Backup and wait for it to complete
  5. Download the backup file (a .zip file)

From On-Premise

Export your database and filestore as a ZIP file containing:

  • dump.sql - PostgreSQL database dump
  • filestore/ - Attachments and uploaded files

Step 2: Start the Migration

  1. Go to Migrations in the sidebar
  2. Click New Migration
  3. Select your source type (Odoo.sh, On-Premise, Odoo Online, or Other PaaS)
  4. Enter a project name
  5. Accept the data processing consent

Your backup is encrypted at rest and automatically deleted after 30 days.


Step 3: Upload Your Backup

File Upload (up to 50GB)

Upload directly through the wizard. Large files are handled automatically:

  • Under 50MB: Direct upload
  • 50MB - 500MB: Automatic chunked upload
  • 500MB - 5GB: Multipart upload
  • Over 5GB: Accelerated upload

Cloud URL Import

Alternatively, paste a URL from:

  • Google Drive
  • Dropbox
  • OneDrive
  • Any direct download URL

Step 4: Analysis

After uploading, OEC.sh analyzes your backup and detects:

  • Odoo version
  • PostgreSQL version
  • Database name and size
  • Filestore size
  • Installed modules (Odoo, OCA, and custom)
  • Business data (partners, users, invoices, products)
  • Recommended server resources
  • Estimated monthly cost savings vs Odoo.sh

Step 5: Configure and Deploy

  1. Review the analysis results
  2. Choose to create a new project or select an existing one
  3. Click Deploy Migration

The system handles the rest:

  • Creating the project and environment
  • Deploying containers
  • Downloading and extracting the backup
  • Restoring database and filestore
  • Configuring routing
  • Starting Odoo

You can track progress through 12 detailed steps in the Technical Details section.


Post-Migration Checklist

  1. Test user login
  2. Check a few file attachments
  3. Update email settings (SMTP configuration)
  4. Update webhook URLs and API endpoints
  5. Point your domain to the new environment
⚠️

SMTP configuration needs to be updated after migration. Go to Settings and configure your outgoing mail server.


Data Protection

  • Redeploying preserves all data added since migration
  • The original backup is only restored once
  • Migration timestamps are recorded for audit
  • You can re-restore the original backup if needed (requires confirmation)

Managing Migrations

Cancel a Migration

During upload, analysis, or configuration phases, you can cancel the migration:

  1. Go to Migrations and select your migration
  2. Click Cancel Migration
  3. Confirm the cancellation

Retry a Failed Migration

If a migration fails:

  1. Go to Migrations and select the failed migration
  2. Review the error message
  3. Click Retry to restart from the failed step

Troubleshooting

IssueSolution
Upload stuckTry using a cloud URL instead of direct upload
Backup not recognizedRe-export from source using official backup format
Large database restore takes longNormal for databases 5GB+. OEC.sh monitors progress in real-time with no timeout limits. See Backup & Restore for timing guidelines.
Analysis failedVerify backup contains dump.sql and filestore