Introduction #
Migrating your Odoo instance to Cloudpepper from Odoo.sh requires only a few steps. Consider migrating after business hours to avoid any data being written into the system during the process.
Requirements #
- Access to Odoo.sh
- A server provisioned by Cloudpepper
- Active backup provider with Cloudpepper
Step 1. Download a database dump on Odoo.sh #
First, we need to download your Odoo database and filestore. Consider creating a fresh backup of your production instance to have the most recent data. Once the manual backup is ready, go to the Backups tab. Find the backup and click Download.
This will open a pop-up window to prepare the download of your backup. Select Exact database dump and With filestore. Click Start to prepare the download.
Once the process is completed, you will receive a notification that your database dump is ready. Click Download to start downloading the .zip file.
Step 2. Import your Odoo instance into Cloudpepper #
Open the Backups section and click on Import.
Upload the .zip file containing your Odoo instance you downloaded from Odoo.sh.
The online import tool supports Odoo databases of up to 5GB. For migrating larger databases, you can use this procedure to migrate your database.
Once uploaded, go to the Restore instance option of the imported backup.
Choose the server and the domain name you want to use for your Odoo instance.
Ensure that you have set the DNS A record of your domain name to the IP address shown on the dialog (the IP address of your Odoo server).
Click Restore instance.
The Odoo instance is now being created. For small Odoo databases this process takes less than 5 minutes.
Step 3. Enable Odoo Enterprise #
As you are migrating from Odoo.sh, you are using Enterprise modules which have changed the Odoo database structure. Therefore you will need to enable Enterprise.
Step 4. Add custom modules #
As a final step, you will need to add your custom modules to your instance. You can add a GitHub repository by opening the Addons tab of your instance. Click Add from GitHub and select the repository containing your custom modules.
Troubleshooting #
Test your Odoo instance on Cloudpepper #
To first test out your Odoo instance, you can choose a different temporary domain name or use a free .cloudpepper.site subdomain when restoring your backup to an instance.
Once you are satisfied with the results, you can safely change the domain name to your production domain name under your instance settings.
Internal Server Error #
If your Odoo instance shows an internal server error, please go to the Logs section of your Odoo instance. Most errors are caused by a missing Python library. To install the Python library, log in with SSH into your server and install the library using the PIP command shown on your Cloudpepper dashboard under the details section of your Odoo instance.
