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
| Source | Description |
|---|---|
| Odoo.sh | Official Odoo cloud platform |
| Odoo Online | Odoo SaaS offering |
| On-Premise | Self-hosted Odoo installations |
| Other PaaS | Other hosting platforms |
Step 1: Export Your Backup
From Odoo.sh
- Log in to odoo.sh (opens in a new tab)
- Select your project and go to the production branch
- Click the Backups tab
- Click Create Backup and wait for it to complete
- Download the backup file (a
.zipfile)
From On-Premise
Export your database and filestore as a ZIP file containing:
dump.sql- PostgreSQL database dumpfilestore/- Attachments and uploaded files
Step 2: Start the Migration
- Go to Migrations in the sidebar
- Click New Migration
- Select your source type (Odoo.sh, On-Premise, Odoo Online, or Other PaaS)
- Enter a project name
- 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
- Review the analysis results
- Choose to create a new project or select an existing one
- 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
- Test user login
- Check a few file attachments
- Update email settings (SMTP configuration)
- Update webhook URLs and API endpoints
- 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:
- Go to Migrations and select your migration
- Click Cancel Migration
- Confirm the cancellation
Retry a Failed Migration
If a migration fails:
- Go to Migrations and select the failed migration
- Review the error message
- Click Retry to restart from the failed step
Troubleshooting
| Issue | Solution |
|---|---|
| Upload stuck | Try using a cloud URL instead of direct upload |
| Backup not recognized | Re-export from source using official backup format |
| Large database restore takes long | Normal for databases 5GB+. OEC.sh monitors progress in real-time with no timeout limits. See Backup & Restore for timing guidelines. |
| Analysis failed | Verify backup contains dump.sql and filestore |