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 1 — Create a project​

  1. From the dashboard, click New Project.

  2. Select your Git provider (GitHub, GitLab, or Bitbucket).

    If this is the first time you connect that provider, Skysize will redirect you to its authorization page. Approve the requested permissions and you will be brought back to the project creation form automatically.

    note

    You only need to authorize a provider once. If you later want to connect an additional provider, go to Account → Integrations.

  3. Choose the organization or workspace that owns the repository.

  4. Select your repository from the list, or type the name 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 license

  7. Select a deployment region closest to your users:

    • Europe (Belgium)
    • North America (USA — Iowa)
    • Asia (Singapore)
    • Oceania (Australia)

  8. Choose the billing account to associate with this project.

  9. Click Create Project.

Skysize will connect to your repository, fetch its branches, and take you to the project dashboard.

Step 2 — Your production branch​

When the project is created, Skysize automatically detects the default branch of your repository (usually main or master), sets it as your production branch, and starts a first deployment immediately. No action is required.

Go to the Deployment tab to see the build in progress.

If you want a different production branch​

If the default branch is not the one you want to use for production:

  1. Open the current production branch settings and set its type to None.
  2. Find the branch you want in the list and set its type to Production.
  3. Skysize will automatically start a new deployment for that branch.
note

The first deployment creates a brand new database with only the base Odoo module installed. Once the deployment is done, 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 build status to show Success. This typically takes a few minutes.
  2. Click the Open button next to your production deployment to open your Odoo instance in a new tab.

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

What's next?​

  • Push a code change to your branch — Skysize will automatically trigger a new deployment (if you chose the Update or Create New on-push action).
  • Add a custom module → see Add a Custom Module.
  • Set up a staging environment → see Development Workflow.
  • Add a custom domain → see Custom Domains.