Migrations

Move your Odoo instance to OEC.sh from Odoo.sh, Odoo Online, on-premise servers, or other hosting platforms. Keep all your data, customizations, and configurations intact.

What Gets Migrated

• Your complete database (customers, invoices, orders, etc.)
• All file attachments and uploads
• Custom modules and configurations
• User accounts and permissions

Supported Sources

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

Step 3: Upload Your Backup

File Upload (up to 50GB)

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

• 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 automatically 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 everything automatically:

• 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

Data Protection

Your data is protected after migration:

• 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

What's Next?

• Set up automatic backups
• Configure a custom domain
• Invite team members
• Monitor your environment