For Developers

The platform uses some memory and CPU-usage limits in order to ensure a fair use of server resources.

This means that idle Odoo workers may be terminated after a reasonable amount of time and will be automatically respawned upon the next activity.

The usage of is subject to the same Acceptable Use Policy than the usage of Odoo Online.

Yes, the containers have a (nearly) unrestricted access to the Internet.


  • Port 25 is (and will stay) closed. If you want to connect to an external SMTP server, you should use ports 465 and 587.
  • Long-living connections may not survive to worker recycling. We discourage you to implement long-living connections to external services.

Yes ! The platform will automatically detect your addons folders based on the manifest files ( of each addon.

This is actually how submodules work: If you add a repository containing Odoo addons as a submodule of your branch, the folder holding the submodule will be detected as an addons folder to include in the addons path of your database.

A git submodule allows you to integrate other Git projects into your code, without the need to copy-paste all the code (in short).

Required before starting: a Git repository containing some Odoo modules. It can be some apps from the Odoo Apps store or some community modules.

Private repositories

Github private repositories require a few more steps in order to configure properly your submodules. They ensure that will be able to fetch your private code.

  1. Go to your project Settings then look for the Submodules section.
  2. Paste the URL of your sub-repository (eg: and click on Add.
  3. Copy the Public key (it should look like ssh-rsa We currently support ssh-rsa and ssh-ed25519 keys.
  4. Go to your sub-repository Settings page on Github then look for the Deploy keys tab.
  5. Click on Add deploy key and paste the public key into the Key field. You can add "" as title and save.
  6. Now follow the steps described hereunder for the Public repositories.
Public repositories

Here are the steps to add your sub-repository as a submodule of your project (you don't need to set up a deploy key for public repositories).

  1. Let your project "know" that you require a submodule: git submodule add -b BRANCH PATH.
  2. Commit this change and push it: git commit -a && git push -u origin master.
  3. Wait while builds your project... and it's done!
Python dependencies:

You can define requirements.txt files in your branch holding the python dependencies your project relies on. These requirements files can be placed in the root of the folders containing your addons. The platform will then install the dependencies for each build.

System dependencies:

This is currently not possible to install system packages (e.g. apt packages).

Nevertheless, if the package could be useful for more than one project, we will consider to install it by default in the containers images if the package meets the following requirements:

  • there should be not conflict with the rest of the packages
  • the software should not run as (or depend of) a long running service or daemon
  • no elevated privileges or additional system user should be required
  • the software should not directly or indirectly represent a security attack vector
  • the software should run flawlessly in a constrained linux namespace environment with cgroup limits on memory, processes, threads, files, ... (this excludes greedy VMs such as java)
Same goes for python modules requiring system packages for their compilation. In such a case, leave us a feedback and provide us with some details about your use-case.

Please note that accepted system packages will be kept as long as the above conditions are met. Should a conflict arise when the platform is moving to a more recent OS distribution, it may be removed.

PostgreSQL dependencies:

PostgreSQL extensions are not supported on hence it is not possible to install extensions (such as PostGIS, ltree, ...) in an database.

Yes, there is an API to interact with your Odoo databases hosted on

Each Odoo build comes with an XML-RPC interface. It allows you to interact from an external application. You can find here the documentation for the Odoo API.

In order to connect to your database, you will need:

  1. the database URL (eg:
  2. the port number is 443
  3. the database name can be found in the shell by typing psql and checking the prompt invite name (the part before the =>)
  4. the login and password for the desired user

Platform API

If you are looking for an API to interact with the platform (eg: creating a new project, new branches or requesting a rebuild), this is not planned to be developed for now.

Deleting the Github repository does not delete the project, for the simple reason that an accidental deletion of the repository could potentially drop a production database without any warning.

If you wish to create another project, you must first delete the old one. You can do so by going to the page<your_project>/settings and follow the deletion procedure at the bottom of the page.

Support for other SCM such as Gitlab, Bitbucket... might land in at some point in the future but these are currently considered as a low priority in the features wishlist.

That said, you still have a mean to use a repository hosted by another provider than Github on by using an intermediate Github repository which links to your repository through a submodule. This is less comfortable than using Gitlab, Bitbucket... directly but this is a workaround you'd want to consider.

For Testers

All development instances are accessed using the usual demo data credentials:

  • admin/admin
  • demo/demo
  • portal/portal

When a branch is switched to production, the credentials are admin/admin.
You then have to set them up yourself as you would on an on-premise installation.

Once the production database is set, every staging branch will be a duplicate of the production database, including the users & credentials.

Yes, but port 25 is not allowed.

For more information, refer to the question Do I have Internet access on containers?

Builds are garbage collected after some time to make room for new development builds (production instances are, naturally, excluded from this process).

If you wish to rebuild an instance for an existing branch, you can use the "Rebuild" button on the Builds page.

The platform will automatically lock databases that are expired for more than 3 months. If this was a staging or development build, simply use the "Rebuild" button on the Builds page to have a new one. If you need to salvage the expired database you can still download its dump. If it's a production database, you can start over by drag and dropping the production branch to development and back to production to make a fresh start, or you can contact us if you need it unblocked.

Development branches are always built with demo data installed. Only production branches are created completely empty.

The point of the development branches is to run the unit tests. Currently, in Odoo, these unit tests depends on the demo data.

In the future, if the test data get separated from the demo data, we would then consider the possibility to create development builds without demo data.

For Project Managers

  • Partners: Freely.
  • Enterprise customers: You must subscribe to, meaning your enterprise subscription has to include is available only for customers that are on our new pricing model (Users + Apps)
You can read our pricing to know more about the costs of

If the free offer for partners changes in the future, we guarantee that any project created under this offer will remain free for the same set of features.

When creating your project, if you have the error message:
The subscription <referral code> does not appear to be valid for
It means your subscription is either not a partnership subscription, either this is an enterprise subscription which does not include

Yes, you can.

If you decide you no longer want your production database to be hosted by, you can download a dump of your database and import it on your own Odoo server.

You can download a dump of your database at any time on the builds page of your project.

The Odoo releases used by are the releases you can download and install on your own machines, and which are officially supported to be used as on-premise installation. For that matter, we do not plan to use the saas releases of Odoo, which are not meant to be installed on an on-premise installation.

For System Administrators

Yes, on production or staging branches under the backups tab you can import a database dump. Make sure it is of the requested format and runs on the same version of Odoo.

In the settings page of your project, under the section "Custom domains", you will be able to add custom domains for your production database.

Once your domain added to this list, you will have to set the DNS entries in the manager of your domain name registrar.
Perform the following operations:

  • Create a CNAME record pointing to <yourdatabase>
  • If you want to use the naked domain (e.g., you need to redirect to
We do not allow to configure naked domains in the platform because these domains must be configured with A records which only accept IP addresses as possible values. The IP address of each database can change, following an upgrade or a hardware failure, and this would mean the configuration of the A record for the naked domain could suddenly no longer work, without notification.


SSL is enabled by default. If the redirection is correctly set up, the platform will automatically generate an SSL certificate with Let's Encrypt within the hour.
It is currently not possible to configure your own SSL certificates on the platform. We are considering the feature.

Production builds are backuped every 24 hours.

We keep 14 full backups of each Odoo production instance for up to 3 months: 1/day for 7 days, 1/week for 4 weeks, 1/month for 3 months.

You can also download manual backups of your live data at any time using the "Download dump" button.

We do not backup nor ensure recovery for development builds, as they are assumed not to be used as persistent data storage

This is not possible because the Odoo hosting platforms (Odoo Online and do not expose the postgresql clusters to the internet.

If you need to communicate with a third party system/application (E-commerce, BI reporting, ...), you will need to setup the integration at the http layer.

Keep in mind that in case you need to periodically import data into an database, you should use the #load() method of the model you want to import into (instead of making one rpc request per row to create/update) otherwise the requests might be rate limited.

Currently, uses the following GCP data centers:

In case you are unsure about which zone to choose for your location, using some GCP online ping tools might help.

Please note that the locations of the data centers within a zone are not contractual.

It is indeed possible to transfer the ownership of the repository linked to your project.

After performing the transfer, the platform will be updated through the next commit you push. Even an empty commit would do the trick. If in doubt, just use the following command and will know your repository has a new owner:

git commit --allow-empty -m "Changed repository ownership"; git push