Create a project

Deploy a platform

1. Visit Odoo.sh and click Deploy your platform.

   

2. Sign in with a GitHub account.

   

3. Authorize Odoo.sh by clicking Authorize odoo twice.

   

   Nota

   Odoo.sh requests GitHub to:

   • Access your GitHub login and email.

   • Create a new repository, in case you start from scratch.

   • Access existing repositories, including organization ones, in case you start from an existing repository.

   • Create a webhook to notify you each time changes are pushed.

   • Commit changes for easier deployment.

4. Fill in the Deploy your platform form and click Deploy:

   • Github repository: to create a new repository, choose New repository and enter a name; to use an existing one, choose Existing repository and select it.

   • Odoo Version: select the major version of Odoo you want to use.

     Suggerimento

     • Use the latest major version of Odoo version when creating a new repository. If you are planning to import an existing database or applications, it might be required that their versions match.

     • If you are starting on Odoo Online and plan to migrate to Odoo.sh later, create your database using odoo.com/start-lts to ensure compatibility, as minor versions are not supported by Odoo.sh.

   • Subscription Code: enter your Odoo Enterprise subscription code that includes Odoo.sh. It is also sometimes called the subscription referral, contract number, or activation code.

     Suggerimento

     Partners can use their partnership codes to initiate a trial (trial builds are limited to 1 GB storage and two staging). If a client proceeds to start a project, they must subscribe to an Odoo Enterprise plan that includes Odoo.sh hosting and use their subscription code.

   • Hosting location: select the region where your platform will be hosted.

   

Import a database

Once your platform is deployed, you can import a database into your Odoo.sh project, provided it uses a supported version of Odoo.

Nota

Due to Odoo’s backup policy, the import process requires four times the size of your database dump in available storage. For example, a 10 GB dump file will require at least 40 GB of available space. We recommend allocating more than four times× the dump size temporarily, then reducing storage after the import is complete.

If your project is a trial created with a partnership code, you can only import database dumps up to 1 GB in size.

Push modules in production

If you are using community or custom modules, add them to a branch in your GitHub repository.

Nota

Databases hosted on Odoo Online do not support custom modules.

Odoo.sh automatically detects folders containing Odoo modules. You can organize them however you prefer. For example, you can place them directly in the root directory of your repository or group them by category (e.g., accounting, project, etc.).

For publicly available community modules, you may also consider using submodules.

Scaricare un backup

On-premiseOdoo Online

Go to /web/database/manager on your on-premise Odoo instance and click Backup.

Select zip (includes filestore) as the Backup Format.

Nota

• You will need the Master Password of your Odoo server. If you do not have it, contact your system administrator.

• If you cannot access the database manager, it may have been disabled by your system administrator. Refer to the database manager security documentation.

Caricare il backup

In your Odoo.sh project, navigate to the Backups tab of your Production branch, and click Import Database to upload the backup you previously downloaded.

Once the import is complete, you can access the database using the Connect button in the branch’s History tab.

Importante

Importing a backup overwrites all data currently in the branch. Consider downloading a manual backup beforehand if you want to preserve the existing data.

Check outgoing email servers

Odoo.sh provides a default email server. To use it, ensure that no outgoing mail server is enabled in your database by enabling developer mode and navigating to Settings ‣ Technical ‣ Email: Outgoing Mail Servers

After importing your database, all configured outgoing mail servers are disabled, and the default Odoo.sh server is used.

Avvertimento

Port 25 is and will remain closed. If connecting to an external SMTP server, use port 465 or 587.

Check scheduled actions

Scheduled actions are disabled by default after importing your database. This prevents your newly imported database from performing potentially disruptive operations such as:

• sending queued emails,

• triggering mass mailings, or

• syncing with third-party services (e.g., calendars, cloud storage).

If you intend to use this imported database in production, re-enable only the scheduled actions you need by enabling developer mode and going to Settings ‣ Technical ‣ Automation: Scheduled Actions.

Register the subscription

After import, the database is considered a duplicate and will be unlinked from your enterprise subscription.

Nota

You are allowed only one active database per subscription.

If you intend to make the imported database your production environment:

1. Unlink your previous database from the subscription.

2. Register the new one.

Refer to the database registration documentation for step-by-step instructions.