Skip to main content

Deploy Your First Instance

In this tutorial you will connect a Git repository to Skysize and deploy a live Odoo instance. By the end, you will have a running production environment accessible at a skysize.io subdomain.

Time to complete: ~10 minutes

What you need:

  • A Skysize account
  • A GitHub, GitLab, or Bitbucket account
  • An Odoo repository (or a fork of one)

Step 0: Connect your Git provider (one time)​

Before you can create a project, Skysize needs permission to read your repository.

  1. Click Connect GitHub (or GitLab / Bitbucket) and approve the requested permissions on your provider's authorization page.
  2. You are returned to Skysize automatically once the connection is established.
note

You only need to authorize a provider once, the connection is reused for every project. You can connect more than one provider and manage your connections at any time.

Step 1: Create a project​

  1. From the Projects page, click New Project.
  2. Enter a project name.
  3. Choose your Git connection from the dropdown (the provider you authorized in Step 0).
  4. Select your repository from the list. You can start typing to filter.
  5. Choose the Odoo version that matches your codebase (16.0, 17.0, or 18.0).
  6. Select the edition:
    • Community: open-source Odoo
    • Enterprise: requires a valid Odoo Enterprise subscription, which you activate from inside your Odoo database once it is running
  7. Select a deployment region closest to your users:
    • Europe (Belgium)
    • North America (USA, Iowa)
    • Asia (Singapore)
    • Oceania (Australia)
  8. Click Create.

Skysize connects to your repository, discovers its branches, and takes you to the project dashboard.

Step 2: Your production branch​

When your project is ready, Skysize promotes the repository's default branch (usually main or master) to Production, sets it to deploy automatically on every push, and starts the first deployment. No action is required to get your production environment live.

Open the Deployments tab to watch the build progress through its stages (cloning the repository, pulling the image, initialising the database, starting the container).

Choosing a different production branch​

Every branch in your repository is listed on the Branches tab. If you want a branch other than the default to be production:

  1. Open the Branches tab and click the branch you want to promote.
  2. In the Branch Type section, select Production and click Save.
  3. Skysize starts a new deployment for that branch.
note

A branch's type is always one of Production, Staging, or Development, there is no "off" state. Each project has exactly one production branch at a time, so promoting a different branch to Production replaces the previous one.

note

The first deployment creates a brand-new database with only the base Odoo module installed. Once the deployment finishes, log in to your Odoo instance and install the modules you need from the Apps menu.

Step 3: Access your instance​

  1. Wait for the deployment status to show running (the build status reaches Success). This typically takes a few minutes.
  2. Click the Login button on your production deployment to open your Odoo instance in a new tab.

Your instance is now live at your-project-name.skysize.io.

tip

If the build fails, open the deployment and click View Logs to see exactly which step failed. Most first-deployment failures are caused by a missing Python dependency in requirements.txt or an error in a module's manifest.

What's next?​

  • Push a code change to your production branch, because it deploys on push, Skysize automatically triggers a new deployment.
  • Add a custom module → see Add a Custom Module.
  • Set up a staging environment → see Development Workflow.
  • Add a custom domain → see Custom Domains.