Skip to content

Deploy your first environment

An environment is a running Odoo of a project, on one of your servers, at its own address. You need a prepared server and a project with a repository.

  1. Open Environments and press New environment.
  2. Choose the Project and the Server.
  3. Enter a Name (lowercase letters, digits and -, for example shop-staging).
  4. Choose the Type: dev, staging or production.
  5. Leave the rest empty for the usual values, or set them: see Create an environment.
  6. Press Create environment.

Nothing starts on the server yet.

On the environment’s page, press Deploy.

A task drawer opens with the live log. The deploy fetches your code on the server, writes the environment’s files, creates the database the first time, starts Odoo, and asks for its login page through the server’s proxy. When that page answers, the deploy is done.

The Overview tab shows the environment’s address, like https://shop-staging.apps.sbx09.online. The address has its own certificate, so it opens over HTTPS.

The first deploy gives Odoo’s admin user a random password before Odoo starts.

  1. On the Overview tab, find the card First login to Odoo.
  2. Press Show. Showing it is written to the audit log.
  3. Sign in to Odoo with the login admin and that password, then change it in Odoo.

Only owners and admins can see this card. The platform keeps only this first password: it cannot reset one you changed and forgot.

The task’s log ends with the reason in plain words, and the Overview tab shows it under Last error. Two common ones:

  • Modules for another Odoo version. A module in the project’s repository whose manifest names a different Odoo version stops the deploy. Fix the branch or the module.
  • The server is not prepared. Open the server and press Prepare.

Fix the cause and press Deploy again. A deploy can always be run again.